在Spring Boot中使用自定义横幅(Banners)

更新于 2025-12-30

baeldung 2025-06-02

1. 概述

默认情况下,Spring Boot在应用程序启动时会显示一个横幅。这个横幅是“Spring”这个词的ASCII艺术表示形式。然而,我们可以用自定义的ASCII艺术横幅来替换它。

在这篇教程中,我们将学习如何使用ASCII艺术创建一个自定义横幅。

2. 创建横幅

首先,让我们使用诸如 @, #, *, 和 8 等字符组合创建ASCII艺术横幅以形成Baeldung标志:

(此处应有示例图片或ASCII艺术文本)

接下来,将ASCII艺术保存为banner.txt并放置在资源文件夹的根目录下。Spring Boot会自动检测该位置的banner.txt并使用它代替默认横幅。

3. 使用自定义横幅

在上一节中,我们创建了一个ASCII艺术横幅,并将其放在了资源文件夹中以便Spring Boot自动检测。

然而,如果我们想要使用不同的文件名或位置,可以通过在application.properties文件中使用spring.banner.location属性指定横幅的位置:

spring.banner.location=classpath:/path/to/banner/bannername.txt

这里,我们指定了到自定义ASCII艺术横幅的路径。

3.1. Spring Boot 3.0.0 M2之前的图像支持

在Spring Boot版本3.0.0 M2之前,我们可以使用格式如.gif、.png和.jpg的图像横幅。像banner.txt一样,Spring Boot期望此文件名为banner.gif、banner.png或banner.jpg。

或者,可以将图像放置在一个自定义位置,并使用application.properties中的spring.banner.image.location属性引用它:

spring.banner.image.location=classpath:banner.gif

通常,基于文本的横幅更好,因为根据所使用的图像复杂度,图像横幅可能会增加应用程序启动时间。

从Spring Boot版本3.0.0 M2开始,不再支持GIF、JPEG和PNG等图像格式,仅支持banner.txt格式。

4. 结论

在本文中,我们了解了如何在Spring Boot应用程序中创建和使用自定义ASCII艺术横幅。