1. 概述

默认情况下,Spring Boot 在应用启动时会显示一个 Banner,这个 Banner 是由 ASCII 艺术字组成的 "Spring" 标志。不过,我们可以用自定义的 ASCII 艺术字来替换它。

本文将介绍如何创建并使用自定义的 ASCII 艺术字 Banner。

2. 创建自定义 Banner

首先,我们使用 @#*8 等字符组合创建 Baeldung 的 Logo 作为 ASCII 艺术字:

Baeldung ASCII Logo

接下来,将 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.gifbanner.pngbanner.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 的支持情况(已废弃)

通过简单的配置,就能让应用启动时显示个性化的标识,提升开发体验。


原始标题:Using Custom Banners in Spring Boot | Baeldung

« 上一篇: Javassist 介绍
» 下一篇: Ratpack 介绍