Spring Boot：启动Banner的自定义与禁用策略

Spring Boot 启动 Banner 修改及关闭指南

一、Banner 是什么

Banner 是在启动 Spring Boot 项目后，控制台打印的横幅信息。如下图所示：

  ____        _ __                __
 / __ )__  __(_) /_____  ____     / /
/ __  / / / / / __/ __ \/ __ \   / / 
/ /_/ / /_/ / / /_/ /_/ / /_/  /_/  
/_____/\__,_/_/\__/\____/\___(_)

二、如何修改 Banner

我们可以通过在 Spring Boot 项目的 resources 文件夹下创建一个 banner.txt 文件来修改 Banner。Spring Boot 启动时会自动加载该文件并显示其中的内容。

以下是一个自定义的 Banner 示例（以CaiCai的一个banner为例）：

_______________________________________
      __                 __
    /    )         ,   /    )         ,
---/---------__-------/---------__-----
  /        /   ) /   /        /   ) /
_(____/___(___(_/___(____/___(___(_/___ 

启动时，控制台中的 Banner 就会变成我们自定义的内容。

Banner 的其他自定义配置

除了纯文本，Spring Boot 还支持使用占位符和颜色配置来进一步定制 Banner。常见的占位符和配置包括：

• ${AnsiColor.BRIGHT_RED}：设置控制台输出内容的颜色。
• ${application.version}：获取 MANIFEST.MF 文件中的应用版本号。
• ${application.formatted-version}：格式化后的应用版本号。
• ${spring-boot.version}：Spring Boot 的版本号。
• ${spring-boot.formatted-version}：格式化后的 Spring Boot 版本信息。

Banner 生成工具

为了简化 Banner 的生成，推荐几个在线工具，支持生成文字、图片的 ASCII 图形：

• http://patorjk.com/software/taag/
• https://www.bootschool.net/ascii
• http://www.network-science.de/ascii/
• https://www.degraeve.com/img2txt.php

三、如何关闭 Banner

默认情况下，Spring Boot 启动时会显示 Banner。如果你想关闭它，可以通过以下三种方法实现：

1. 通过代码关闭

在启动类的 main 方法中，通过设置 Banner.Mode.OFF 来关闭 Banner：

/**
 * @author zhangz1
 */
@SpringBootApplication
public class SpringBootDemoApplication {
    
    

    public static void main(String[] args) {
    
    
        SpringApplication springApplication = new SpringApplication(SpringBootDemoApplication.class);
        // 关闭 Banner
        springApplication.setBannerMode(Banner.Mode.OFF);
        springApplication.run(args);
    }

}

2. 在 application.properties 中配置

在项目的 application.properties 文件中添加以下配置：

spring.main.banner-mode=off

3. 通过编辑器设置（以 IntelliJ IDEA 为例）

在 IDEA 中，可以通过以下步骤关闭 Banner：

• 点击 Run/Debug Configurations，选择需要修改的启动配置。
• 点击 Modify options，在弹出窗口中选择 Hide Banner。

（注：IDEA 版本不同，具体操作可能有所不同。）

---

通过以上方法，你可以轻松修改或关闭 Spring Boot 启动时的 Banner，打造属于自己的定制化启动界面！