Spring Boot框架在启动应用时，控制台通常会输出一段由ASCII字符组成的Spring标志图案，这个图案被称为Banner。虽然它看起来只是一个简单的启动装饰，但在实际的企业级项目交付或开源组件开发中，一个定制化的Banner不仅能提升品牌形象，还能在控制台输出一些关键的应用版本、构建时间等元数据信息。要深入理解如何整合并启用自定义Banner，我们需要从其底层的加载机制入手，逐步过渡到文件配置和代码级别的深度定制。
Spring Boot Banner的底层加载机制
Spring Boot的启动流程中，横幅的打印是由SpringApplication类的run方法触发的。在准备启动环境的过程中，框架会调用printBanner方法。这个方法并不是随意执行的，它首先会检查当前的BannerMode配置。BannerMode是一个枚举类，提供了三种模式：CONSOLE（仅输出到控制台）、LOG（仅输出到日志文件）和OFF（关闭横幅输出）。默认情况下，Spring Boot采用CONSOLE模式。
当确定需要打印横幅后，框架会实例化一个Banner接口的实现类来执行具体的打印逻辑。默认的实现类是SpringBootBanner。在这个类的printBanner方法中，框架会尝试从类路径下加载名为banner.txt的文本文件。如果找到了该文件，就会读取其内容并打印到指定的输出流中；如果没有找到，则会使用硬编码在SpringBootBanner类中的默认ASCII图案。这种设计使得开发者只需在资源目录下放置一个特定名称的文件，就能覆盖默认行为。
除了简单的文本读取，SpringBootBanner还内置了变量解析功能。这意味着banner.txt文件中不仅可以包含静态的ASCII字符画，还可以使用占位符来动态获取环境变量或配置文件中的值。这种机制为我们在启动横幅中展示动态信息提供了底层支持，使得横幅不再是一成不变的死板图案，而是能够反映当前应用运行状态的动态信息板。
通过配置文件与资源文件快速定制横幅
最简单且最常用的自定义Banner方式是通过资源文件进行配置。开发者只需在项目的src\main\resources目录下创建一个名为banner.txt的文件，并在其中编写自己想要的ASCII字符画或文本信息。当Spring Boot应用启动时，框架会自动检测到这个文件，并用它的内容替换掉默认的Spring标志。这种方式零代码侵入，修改起来非常方便。
在banner.txt文件中，我们可以利用Spring Boot提供的特殊变量来丰富横幅的内容。例如，使用${application.version}可以获取应用的版本号，使用${application.title}可以获取应用名称，使用${spring-boot.version}可以获取框架版本。此外，还可以使用${AnsiColor.BRIGHT_CYAN}这样的枚举变量来改变控制台输出字符的颜色，让横幅更加醒目。需要注意的是，如果项目构建工具使用的是Maven，还可以通过@project.version@来引用POM文件中的属性。
如果某些场景下需要关闭横幅输出，比如在脚本化部署中为了保持控制台日志的整洁，可以通过配置文件或代码来实现。在application.properties或application.yml文件中，设置spring.main.banner-mode=off即可彻底关闭横幅。如果只是想将横幅输出到日志文件而不是控制台，可以将其设置为log。这种基于配置的开关方式，为不同环境下的应用启动提供了灵活的控制手段。
编程式实现自定义EnableBanner逻辑
当简单的文本文件无法满足复杂的定制需求时，例如需要根据不同的环境动态生成不同的横幅，或者在横幅中嵌入随机的系统状态信息，我们就需要通过编程的方式来实现自定义的Banner。这需要我们实现Spring Boot提供的Banner接口。该接口只有一个方法printBanner，在这个方法中，我们可以拿到Environment对象和资源加载器，从而实现极其复杂的逻辑。
下面是一个自定义Banner实现的代码示例。在这个例子中，我们不仅输出了静态的字符画，还通过Environment对象获取了当前激活的Profile，并将其打印在横幅中。这种方式比单纯的文本文件配置要灵活得多，能够实现诸如根据环境变量动态改变横幅颜色、根据系统时间输出不同的问候语等高级功能。
import org.springframework.boot.Banner;
import org.springframework.core.env.Environment;
import java.io.PrintStream;
public class CustomEnableBanner implements Banner {
@Override
public void printBanner(Environment environment, Class<?> sourceClass, PrintStream out) {
String activeProfile = environment.getProperty("spring.profiles.active", "default");
out.println(" ============================");
out.println(" || Custom Application ||");
out.println(" || Active Profile: " + activeProfile + " ||");
out.println(" ============================");
}
}编写好自定义的Banner类后，还需要将其应用到Spring Boot的启动流程中。这通常是在主启动类的main方法中完成的。我们不能直接使用SpringApplication.run这个静态方法，而是需要手动创建SpringApplication实例，调用setBanner方法注入我们的自定义实现，最后再调用实例的run方法。通过这种编程式的整合，我们完全掌控了横幅的生成逻辑，使其能够完美契合各种复杂的业务需求，真正实现了EnableBanner的深度定制。
Spring BootBanner自定义EnableBanner修改时间：2026-08-25 23:59:03