spring.main.banner-mode 默认为 console，控制 banner 渲染位置：console 输出到控制台，log 输出到日志，off 彻底关闭；其生效优先级高于 banner.txt 是否存在，且 2.x+ 使用该配置，1.x 用 spring.main.show-banner。
Spring Boot 的 spring.main.banner-mode 怎么生效
默认情况下，Spring Boot 启动时会打印 Banner，但如果你放了 banner.txt 却没显示，大概率是 banner 被关了或模式不对。这个配置控制 Banner 是否渲染、在哪渲染（控制台 / 日志 / 关闭），不是“有没有 banner 文件”决定的。
-
spring.main.banner-mode=console（默认）：输出到 System.out，启动日志里能看到 -
spring.main.banner-mode=log：走 SLF4J 输出到日志框架，适合容器环境（如 K8s 日志采集） -
spring.main.banner-mode=off：彻底关闭，连 ASCII 字符都不打——哪怕你有banner.txt也白搭
注意：banner-mode 是 Spring Boot 2.x+ 的写法；1.x 用的是 spring.main.show-banner（布尔值），混用会导致静默失效。
自定义 banner.txt 的位置和编码问题
Spring Boot 只在固定路径找 Banner 文件，且对编码敏感。放错地方或用了 UTF-8 BOM，轻则乱码，重则直接 fallback 到默认 Spring 字符画。
- 优先级从高到低：
src/main/resources/banner.txt→classpath:banner.txt→file:./banner.txt - 必须用
UTF-8 without BOM编码，IDEA 默认可能带 BOM，Sublime 或 VS Code 打开后选 “Save with Encoding → UTF-8” 清掉 - 支持变量替换，比如
${application.version}、${spring-boot.version}，但这些值要真实存在（比如pom.xml里声明了<version></version>）
常见错误现象：??? 或方块乱码 —— 八成是编码问题；全显示默认 Banner —— 检查文件路径是否拼错（比如写成 Banner.txt，Linux 下大小写敏感）。
立即学习“Java免费学习笔记（深入）”；
用 SpringApplication.setBanner() 动态控制 Banner
硬编码 Banner 适合多环境差异化场景，比如测试环境加 [TEST] 标识，生产环境完全隐藏。比纯配置更灵活，但得改 Java 代码入口。
- 在
main()方法里 newSpringApplication后调用setBanner()，不能等run()之后再设 - 实现
org.springframework.boot.Banner接口，或直接用new ResourceBanner(new ClassPathResource("my-banner.txt")) - 如果想彻底不打 Banner，传
new StandardBanner()不行，得传null（Spring Boot 2.3+ 支持）或用setBannerMode(Banner.Mode.OFF)
性能影响几乎为零，但要注意：若 Banner 内容含占位符（如 ${random.int}），每次启动都会触发一次随机数生成，无实际意义还略拖慢冷启动。
Profile 感知的 Banner 切换怎么做
Spring Boot 本身不支持按 profile 加载不同 banner.txt，但可以用资源路径 + profile 激活逻辑绕过去。
- 准备多个文件：
banner-dev.txt、banner-prod.txt，放在src/main/resources/ - 在
main()里读取当前 active profile：System.getProperty("spring.profiles.active")或通过SpringApplication获取Environment - 用
setBanner(new ResourceBanner(new ClassPathResource("banner-" + profile + ".txt")))动态加载 - 别忘了兜底：profile 为空或文件不存在时，fallback 到默认
banner.txt或关闭 Banner，否则启动直接报FileNotFoundException
容易被忽略的是 profile 名称可能含逗号（如 dev,staging），取第一个非空值即可，别直接字符串匹配整个值。
