1. 概述
默认情况下,Spring Boot 在应用启动时会显示一个 Banner,这个 Banner 是由 ASCII 艺术字组成的 "Spring" 标志。不过,我们可以用自定义的 ASCII 艺术字来替换它。
本文将介绍如何创建并使用自定义的 ASCII 艺术字 Banner。
2. 创建自定义 Banner
首先,我们使用 @
、#
、*
和 8
等字符组合创建 Baeldung 的 Logo 作为 ASCII 艺术字:
接下来,将 ASCII 艺术字保存为 banner.txt
文件,并放置在 resources
目录的根目录下。Spring Boot 会自动检测到这个位置的 banner.txt
文件,并用它替换默认的 Banner。
3. 使用自定义 Banner
上一节我们创建了 ASCII 艺术字 Banner,并放在 resources
目录下供 Spring Boot 自动检测。
但如果想使用不同的文件名或位置,可以在 application.properties
文件中通过 spring.banner.location
属性指定路径:
spring.banner.location=classpath:/path/to/banner/bannername.txt
这里指定了自定义 ASCII 艺术字 Banner 的路径。
3.1. Spring Boot 3.0.0 M2 之前的图片支持
在 Spring Boot 3.0.0 M2 版本之前,支持使用 .gif
、.png
和 .jpg
格式的图片作为 Banner。和 banner.txt
类似,Spring Boot 默认会查找名为 banner.gif
、banner.png
或 banner.jpg
的文件。
也可以将图片放在自定义位置,通过 application.properties
中的 spring.banner.image.location
属性引用:
spring.banner.image.location=classpath:banner.gif
⚠️ 建议优先使用文本 Banner,因为图片 Banner 会根据图片复杂度增加应用启动时间。
从 Spring Boot 3.0.0 M2 开始,GIF、JPEG 和 PNG 等图片格式不再支持,仅保留 banner.txt
格式。
4. 总结
本文介绍了在 Spring Boot 应用中创建和使用自定义 ASCII 艺术 Banner 的方法,包括:
- ✅ 基本文本 Banner 的创建与配置
- ✅ 自定义路径的配置方式
- ❌ 旧版本图片 Banner 的支持情况(已废弃)
通过简单的配置,就能让应用启动时显示个性化的标识,提升开发体验。