Quarkus自定义Banner配置不生效问题求助

问题背景 #

已配置Quarkus Banner相关属性，在application.properties中设置：

quarkus.banner.enabled=true
quarkus.banner.path=default_banner11.txt

并在src/main/resources目录下放置了对应txt格式的Banner文件，但运行项目时自定义Banner完全不显示，期望实现类似Spring项目中自定义Banner的效果。

环境信息：

• Java版本：11.0.17 LTS
• Quarkus版本：2.16.5.Final
• 构建工具：Apache Maven 3.9.1

排查与解决步骤 #

1. 确认文件路径与配置严格匹配 #

确保default_banner11.txt直接放置在src/main/resources根目录，未嵌套进任何子文件夹。若文件在子目录中，配置路径需改为子目录名/default_banner11.txt。

2. 验证默认Banner加载状态 #

先注释掉quarkus.banner.path配置，仅保留quarkus.banner.enabled=true，启动项目观察是否显示Quarkus默认Banner：

• 若默认Banner正常显示：说明Banner核心配置生效，问题出在自定义文件本身或类路径加载环节
• 若默认Banner也不显示：排查是否有其他环境配置文件（如application-dev.properties、application-prod.properties）覆盖了quarkus.banner.enabled属性，将其设为false

3. 检查Banner文件编码 #

确保自定义Banner文件使用UTF-8编码保存，非UTF-8编码的特殊字符可能导致Quarkus无法解析加载文件。

4. 确认文件被正确打包到构建产物 #

解压项目构建后的jar包，查看BOOT-INF/classes目录下是否存在default_banner11.txt：

• 若文件不存在：检查Maven的资源过滤配置，确保未排除txt文件。打开pom.xml，查看<resources>节点，若存在如下排除规则需移除：

<resource>
    <directory>src/main/resources</directory>
    <excludes>
        <exclude>*.txt</exclude>
    </excludes>
</resource>

若需保留其他过滤规则，可添加包含规则确保txt文件被打包：

<resource>
    <directory>src/main/resources</directory>
    <includes>
        <include>*.txt</include>
    </includes>
</resource>

5. 绝对路径加载测试（仅用于排查） #

将Banner文件放在本地磁盘路径（如/tmp/default_banner11.txt），修改配置为：

quarkus.banner.path=/tmp/default_banner11.txt

启动项目观察是否加载成功：

• 若成功：说明类路径资源加载存在问题，回到步骤4确认Maven打包配置
• 若失败：检查Banner文件内容是否包含无法解析的控制字符或格式问题

内容的提问来源于stack exchange，提问作者ginbarca