Spring Boot 2.6.9中@Value无法解析占位符问题求助

核心现象 #

• 使用Spring Boot 2.6.9 + Gradle构建，通过@Value注入set.token-uri等配置时，仅当RabbitMQ未启用（app.rabbitmq.enabled=false）时出现占位符解析失败，启用RabbitMQ则启动正常。
• 显式添加@PropertySource("classpath:application.properties")可解决问题，但存在对配置中心兼容性的顾虑。
• 构建产物（build文件夹）中找不到application.properties文件。

可能原因分析 #

1. 配置文件未被正确打包到构建产物 #

Spring Boot默认会将src/main/resources下的配置文件打包到build/resources/main目录（classpath路径），但如果Gradle配置异常，会导致配置文件缺失：

• sourceSets配置未正确包含resources目录
• processResources任务存在排除application.properties的规则
• 自定义Gradle任务覆盖了默认资源打包逻辑

当RabbitMQ启用时，Spring AMQP自动配置会触发额外的环境初始化流程，可能间接加载了未被正确打包的配置文件；而关闭RabbitMQ时，该触发路径消失，导致配置无法被读取。

2. 条件注解触发的配置加载顺序差异 #

启用RabbitMQ时，@ConditionalOnProperty生效，RabbitMQListener被加载，Spring AMQP的自动配置会提前初始化Environment上下文，确保配置文件被正确解析。但关闭RabbitMQ时，该初始化路径缺失，导致配置未被Spring环境上下文读取，进而@Value无法解析占位符。

3. @PropertySource的作用与配置中心兼容性 #

显式添加@PropertySource会强制Spring在启动阶段加载指定配置文件，不受其他自动配置的影响。该操作不会影响配置中心（如Spring Cloud Config）：配置中心的配置优先级高于本地application.properties，且Spring Cloud的配置加载逻辑会自动覆盖或补充本地配置，仅当配置中心无对应属性时，本地配置才会生效。

解决步骤 #

步骤1：确认配置文件打包情况 #

执行gradle build后，检查build/resources/main目录下是否存在application.properties：

• 如果不存在，调整Gradle的sourceSets配置，确保resources目录被正确包含：

  sourceSets {
      main {
          resources {
              srcDirs = ["src/main/resources"]
          }
      }
  }
  

步骤2：检查processResources配置 #

查看build.gradle中是否存在过滤或排除application.properties的规则，例如：

processResources {
    exclude '**/application.properties' // 需要移除该规则
}

若存在上述配置，直接移除排除规则，重新执行构建。

步骤3：验证配置加载状态 #

在启动类中添加日志，打印Environment中的配置属性，确认配置是否被正确加载：

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        ConfigurableApplicationContext context = SpringApplication.run(YourApplication.class, args);
        Environment env = context.getEnvironment();
        System.out.println("set.token-uri loaded: " + env.getProperty("set.token-uri"));
    }
}

如果打印结果为null，说明配置未被加载，需重点排查Gradle打包逻辑；若能正常输出配置值，则问题出在配置加载顺序或Bean初始化时机。

步骤4：替代@PropertySource的方案 #

若不想显式添加@PropertySource，可尝试：

• 在启动类上添加@ConfigurationPropertiesScan（辅助触发配置加载流程）
• 检查是否存在自定义ApplicationContextInitializer干扰了默认配置加载逻辑，如有则调整其执行顺序

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