Spring Boot 中怎么配置 Banner 启动画面与自定义文本

酷杰小哥_2177

酷杰小哥_2177

2026-08-10

526人浏览

原创

spring boot 配置 banner 启动画面无需额外依赖,支持自定义 banner.txt 文本(含占位符与 ansi 颜色)、指定非默认文件路径、图片转 ascii(优先级 gif>jpg>png),并可通过 spring.main.banner-mode 控制显示模式(console/log/off)。

spring boot 中怎么配置 banner 启动画面与自定义文本

在 Spring Boot 中配置 Banner 启动画面,核心是控制启动时显示的 ASCII 文本或图像内容。它不依赖额外依赖,开箱即用,只需按规范放置文件或调整配置即可。

自定义文本 Banner(最常用)

Spring Boot 默认会查找 classpath 下的 banner.txt 文件,并将其内容渲染为启动画面。

  • 把文件放在 src/main/resources/banner.txt 路径下(确保编译后位于 classpath 根目录)
  • 内容支持纯文本、ASCII 艺术字、占位符变量(如 ${application.version}、${spring-boot.version})
  • 可使用 ANSI 颜色控制样式,例如:
    ${AnsiColor.GREEN}MyApp v${application.version}${AnsiColor.DEFAULT}
  • 推荐用在线工具生成字符画,比如 patorjk.com/taag,选 “Standard” 或 “Small Slant” 字体更兼容

指定非默认 Banner 文件名或路径

不想用 banner.txt?可通过配置指定其他文件:

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载
  • 在 application.properties 中写:
    spring.main.banner-file=classpath:my-banner.txt
  • 或在 application.yml 中写:
    spring:<br>  main:<br>    banner-file: classpath:my-banner.txt
  • 注意:该路径必须是 classpath 下可访问的资源,且编码建议为 UTF-8(避免乱码)

用图片生成 Banner(自动转 ASCII)

Spring Boot 支持将图片(.gif、.jpg、.png)自动转为 ASCII 字符画显示:

  • 把图片放入 src/main/resources/banner.png(或 banner.jpg、banner.gif)
  • 默认优先级:gif > jpg > png;若多个同名存在,只读取优先级最高的一个
  • 也可显式指定位置:
    spring.banner.image.location=classpath:logo.png
  • 图片建议简洁、高对比度、无复杂渐变——否则转出的 ASCII 效果可能模糊或失真

控制 Banner 显示行为

是否显示、在哪里显示,由 spring.main.banner-mode 控制:

  • console(默认):输出到控制台
  • log:输出到日志(INFO 级别,记录在 org.springframework.boot.SpringApplication)
  • off:完全关闭 Banner

设置方式任选其一:

  • application.properties:
    spring.main.banner-mode=off
  • application.yml:
    spring:<br>  main:<br>    banner-mode: off
  • 启动类中代码控制:
    SpringApplication app = new SpringApplication(App.class);<br>app.setBannerMode(Banner.Mode.OFF);<br>app.run(args);

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2511

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

2026.10.15

0

20

VS Code 怎么配置开发环境
VS Code 怎么配置开发环境

VS Code开发环境专题汇集编辑器安装、语言扩展、编译器、解释器、终端和调试配置文章,覆盖Java、Python、C++和PHP等常见语言的入门设置。

2026.10.15

0

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习