Spring WebFlux BootJar启动时忽略激活配置与application.yml问题

1. 检查配置文件的打包位置 #

• 确保application.yml放在src/main/resources目录下，打包后用jar tf your-app.jar命令查看，文件应该出现在BOOT-INF/classes/application.yml路径下。如果不在，调整构建工具的资源配置：
  • Gradle：确保sourceSets.main.resources.srcDirs = ["src/main/resources"]
  • Maven：确认pom.xml的resources节点正确指向src/main/resources

2. 强制指定激活的配置文件 #

• Jar启动时通过命令行参数明确激活default配置：

  java -jar your-app.jar --spring.profiles.active=default
  

• 或者直接在application.yml根节点添加默认激活配置，避免依赖Spring自动推断：

  spring:
    profiles:
      active: default
  

3. 核对配置项的层级结构 #

• 确认graphql.packages的缩进和层级正确，别把它嵌套在spring.profiles.default节点下，正确的结构应该是：

  spring:
    profiles: default
  graphql:
    packages: com.your.package.graphql
  

  嵌套错误会导致配置项无法被识别，即使激活了default profile也读不到。

4. 排查构建工具的资源过滤问题 #

• Maven用户检查pom.xml的resources配置，关闭不必要的过滤避免破坏yml文件：

  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <filtering>false</filtering>
      </resource>
    </resources>
  </build>
  

• Gradle用户确认processResources任务没有错误的过滤规则，比如不要随意展开可能和yml语法冲突的变量。

5. 通过日志定位加载细节 #

• 启动Jar时添加日志参数，查看配置加载的详细过程：

  java -jar your-app.jar --logging.level.org.springframework.core.env=DEBUG
  

  从日志里能看到Spring加载了哪些配置文件，以及每个配置项的读取结果，精准定位问题。

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