当前位置：首页 > news >正文

深入探索 Spring Boot 自定义启动画面

news 2026/5/19 12:24:01

引言
什么是 Spring Boot 启动画面
Spring Boot 默认启动画面
为什么要自定义启动画面
如何自定义 Spring Boot 启动画面
- 修改配置文件
- 使用 Banner 接口
- 通过图片实现启动画面
- ASCII 艺术画的应用
进阶：基于环境变量的动态 Banner
多模块项目中的启动画面
Spring Boot 启动画面最佳实践
常见问题及解决方案
结论

引言

Spring Boot 是现代 Java 开发中的一个重要框架，它简化了基于 Spring 的应用程序的创建过程。其快速开发、配置灵活、内嵌服务器等特点使得它在微服务架构中尤为流行。在启动 Spring Boot 应用程序时，会看到一个默认的启动画面（Banner），这个画面不仅仅是一个装饰，还可以包含一些有用的信息。本文将深入探讨如何自定义 Spring Boot 的启动画面，让你的应用程序更加个性化和专业化。

什么是 Spring Boot 启动画面

Spring Boot 启动画面，即 Banner，是在启动 Spring Boot 应用时显示在控制台的一段 ASCII 艺术画或文本信息。这个启动画面默认包含了 Spring Boot 的标识和版本信息，但你可以根据需求自定义其内容。

Spring Boot 默认启动画面

Spring Boot 的默认启动画面包含了 “Spring” 字样的 ASCII 艺术画和版本信息，位于 org.springframework.boot.Banner 类中。默认的启动画面如下：

  .   ____          _            __ _ _/\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \\\/  ___)| |_)| | | | | || (_| |  ) ) ) )'  |____| .__|_| |_|_| |_\__, | / / / /=========|_|==============|___/=/_/_/_/:: Spring Boot ::        (v2.4.5)

为什么要自定义启动画面

自定义启动画面可以为你的应用程序带来以下几个好处：

品牌识别：通过在启动画面中加入公司 Logo 或项目名称，可以增强品牌的辨识度。
信息展示：可以显示项目版本、启动时间、环境变量等有用的信息，便于开发和运维人员快速获取。
个性化：使你的应用程序看起来更加专业和独特。

如何自定义 Spring Boot 启动画面

Spring Boot 提供了多种自定义启动画面的方法，以下是一些常见的方式：

修改配置文件

最简单的方式是通过配置文件来修改 Banner。你可以在 src/main/resources 目录下创建一个名为 banner.txt 的文件，然后将你想要显示的内容写入该文件。

例如：

banner.txt：

  ____              _   _      _| __ )  __ _ _ __ | |_| |_ __| |_ __  __|  _ \ / _` | '_ \| __| __/ _` | '_ \ \/ /| |_) | (_| | | | | |_| || (_| | | | >  <|____/ \__,_|_| |_|\__|\__\__,_|_| |_/\_\:: My Spring Boot Application :: (v1.0.0)

在启动应用程序时，你将会看到自定义的启动画面。

使用 Banner 接口

Spring Boot 还提供了 Banner 接口，你可以通过实现这个接口来自定义启动画面。

首先，创建一个类实现 org.springframework.boot.Banner 接口：

import org.springframework.boot.Banner;
import org.springframework.core.env.Environment;
import org.springframework.core.io.ResourceLoader;import java.io.PrintStream;public class CustomBanner implements Banner {@Overridepublic void printBanner(Environment environment, Class<?> sourceClass, PrintStream out) {out.println("  ____              _   _      _ ");out.println(" | __ )  __ _ _ __ | |_| |_ __| |_ __  __");out.println(" |  _ \\ / _` | '_ \\| __| __/ _` | '_ \\ \\/ /");out.println(" | |_) | (_| | | | | |_| || (_| | | | >  < ");out.println(" |____/ \\__,_|_| |_|\\__|\\__\\__,_|_| |_/_/\\_\\");out.println(" :: My Spring Boot Application :: (v1.0.0)");}
}

然后，在应用程序的启动类中设置自定义的 Banner：

import org.springframework.boot.Banner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class Application {public static void main(String[] args) {SpringApplication app = new SpringApplication(Application.class);app.setBanner(new CustomBanner());app.run(args);}
}

通过图片实现启动画面

如果你希望使用图片作为启动画面，可以使用一些工具将图片转换为 ASCII 艺术画，然后将结果放入 banner.txt 中。

例如，使用 Patorjk 生成 ASCII 艺术画，将其放入 banner.txt：

  _______                   __    __  __/       \                 /  |  /  |/  |$$$$$$$  | __    __  _____$$ |  $$ |$$/  _______$$ |__$$ |/  |  /  |/     $$ |  $$ |/  |/       \$$    $$< $$ |  $$ |$$$$$$$ $$ |  $$ |$$ |$$$$$$$  |$$$$$$$  |$$ |  $$ |$$ |  $$ $$ |  $$ |$$ |$$ |  $$ |$$ |__$$ |$$ \__$$ |$$ \__$$ $$ \__$$ |$$ |$$ |  $$ |$$    $$/ $$    $$/ $$    $$/ $$    $$/$$ |$$ |  $$ |$$$$$$$/   $$$$$$/   $$$$$$/   $$$$$$/ $$/ $$/   $$/

ASCII 艺术画的应用

ASCII 艺术画是一种使用字符组合形成图形的艺术形式，非常适合用来制作启动画面。可以使用在线工具如 ASCII Art Generator 来创建你的启动画面。

以下是一个示例，将 ASCII 艺术画保存到 banner.txt 文件中：

   _____                 _             ____              _   / ____|               | |           |  _ \            | |  | (___  _ __ ___  _ __ | | ___  _   _| |_) | __ _ _ __ | |_ \___ \| '_ ` _ \| '_ \| |/ _ \| | | |  _ < / _` | '_ \| __|____) | | | | | | |_) | | (_) | |_| | |_) | (_| | | | | |_ |_____/|_| |_| |_| .__/|_|\___/ \__, |____/ \__,_|_| |_|\__|| |             __/ |                     |_|            |___/                      :: Spring Boot Custom Banner ::

进阶：基于环境变量的动态 Banner

有时你可能希望根据不同的环境变量来显示不同的启动画面。可以在 Banner 接口实现类中动态生成 Banner 内容。

以下是一个示例，根据环境变量显示不同的 Banner：

import org.springframework.boot.Banner;
import org.springframework.core.env.Environment;import java.io.PrintStream;public class DynamicBanner implements Banner {@Overridepublic void printBanner(Environment environment, Class<?> sourceClass, PrintStream out) {String profile = environment.getProperty("spring.profiles.active");if ("dev".equals(profile)) {out.println("  ____              _   _      _ ");out.println(" |  _ \\  __ _ _ __ | |_| |_ __| |_ __  __");out.println(" | | | |/ _` | '_ \\| __| __/ _` | '_ \\ \\/ /");out.println(" | |_| | (_| | | | | |_| || (_| | | | >  < ");out.println(" |____/ \\__,_|_| |_|\\__|\\__\\__,_|_| |_/_/\\_\\");out.println(" :: Development Environment ::");} else if ("prod".equals(profile)) {out.println("  ____              _   _      _ ");out.println(" |  _ \\  __ _ _ __ | |_| |_ __| |_ __  __");out.println(" | | | |/ _` | '_ \\| __| __/ _` | '_ \\ \\/ /");out.println(" | |_| | (_| | | | | |_| || (_| | | | >  < ");out.println(" |____/ \\__,_|_| |_|\\__|\\__\\__,_|_| |_/_/\\_\\");out.println(" :: Production Environment ::");} else {out.println("  ____              _   _      _ ");out.println(" |  _ \\  __ _ _ __ | |_| |_ __| |_ __  __");out.println(" | | | |/ _` | '_ \\| __| __/ _` | '_ \\ \\/ /");out.println(" | |_| | (_| | | | | |_| || (_| | | | >  < ");out.println(" |____/ \\__,_|_| |_|\\__|\\__\\__,_|_| |_/_/\\_\\");out.println(" :: Default Environment ::");}}
}

然后在 Spring Boot 应用程序的启动类中使用这个自定义的 Banner 类：

import org.springframework.boot.Banner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class Application {public static void main(String[] args) {SpringApplication app = new SpringApplication(Application.class);app.setBanner(new DynamicBanner());app.run(args);}
}

这样，根据 spring.profiles.active 环境变量的不同，启动时会显示不同的启动画面，帮助开发者快速区分环境。

多模块项目中的启动画面

在多模块项目中，每个模块都可以有自己的启动类和自定义 Banner。你可以针对每个模块定义不同的启动画面，以反映出每个模块的独特性和用途。

Spring Boot 启动画面最佳实践

在使用自定义启动画面时，有几点最佳实践值得注意：

简洁明了：启动画面应该简洁明了，不要包含过多的信息，避免干扰应用程序启动过程的主要信息。
品牌标识：合理使用品牌 Logo 和名称，增强应用程序的专业度和品牌识别度。
信息实用：可以显示一些对开发和运维有帮助的信息，如版本号、环境配置等，方便排查问题和调试。

常见问题及解决方案

在使用自定义启动画面过程中，可能会遇到一些常见问题，例如显示不正确或排版混乱等。可以通过以下方法解决：

检查 ASCII 艺术画：确保 ASCII 艺术画的格式正确，每一行的字符数一致，避免出现排版问题。
调整控制台宽度：有时候控制台的宽度会影响 ASCII 艺术画的显示效果，可以调整控制台的宽度来适应。
使用工具生成：可以使用在线工具生成 ASCII 艺术画，确保其格式正确。

结论

通过本文的介绍，你了解了如何在 Spring Boot 应用程序中自定义启动画面。无论是简单的文本信息还是复杂的 ASCII 艺术画，都可以根据你的需求进行定制。自定义启动画面不仅可以增加应用程序的个性化特色，还能提升开发和运维过程中的信息展示和识别效率。希望本文能够帮助你更好地理解和应用 Spring Boot 启动画面定制技术，为你的应用程序增添一份独特的魅力！

目录

引言