多@ConfigurationProperties加载异常：仅加载单个配置类问题排查

核心问题定位 #

你的问题本质是Spring Boot多环境下，项目自身的application-int.properties被依赖ocr-client中的同名配置文件覆盖，导致AppProp（前缀pbc）无法读取到项目配置，进而触发空指针异常；而ClientProp（前缀ocr）能正常加载是因为依赖中的配置正好包含该前缀的属性。

排查与解决步骤 #

1. 验证配置文件加载顺序 #

先确认Spring Boot实际加载的配置文件顺序，添加日志配置：
在项目的application-int.properties中加入：

logging.level.org.springframework.context.support=DEBUG
logging.level.org.springframework.boot.context.properties=DEBUG

启动项目后，查看日志中类似Loading property source from location [classpath:/xxx.properties]的条目，确认项目自身的application-int.properties是否被加载，以及加载顺序是否在依赖的配置文件之后。

2. 强制提升项目配置文件优先级 #

通过Spring Boot的配置参数，强制让项目自身的配置文件优先加载：

• 启动参数方式：在启动命令中添加：

  --spring.config.additional-location=classpath:/application-int.properties
  

  该参数会将指定的配置文件追加到加载链的最前面，优先于依赖中的同名文件。
• 配置文件方式：在项目的application.properties（通用配置）中添加：

  spring.config.additional-location=classpath:/application-int.properties
  

3. 显式指定配置类的文件来源 #

给AppProp配置类添加@PropertySource注解，明确指定加载项目自身的配置文件，避免被依赖的配置干扰：

@ConfigurationProperties(prefix = "pbc")
@PropertySource("classpath:/application-int.properties")
public class AppProp {
    // 属性与setter方法
}

如果需要适配多环境，可以用SpEL表达式动态指定：

@PropertySource(value = "classpath:/application-${spring.profiles.active}.properties")

4. 修改项目配置文件名避免冲突 #

直接重命名项目的环境配置文件，比如改为application-int-project.properties，然后修改激活的profile：

• 在启动参数中指定：

  --spring.profiles.active=int-project
  

• 或者在通用配置中设置：

  spring.profiles.active=int-project
  

这种方式从根源上避免了和依赖配置文件的重名冲突，最彻底。

5. 检查依赖的配置加载逻辑 #

查看ocr-client依赖的源码，确认是否存在以下情况：

• 依赖中使用了@PropertySource注解主动加载application-int.properties；
• 依赖中配置了spring.config.location或相关参数修改了配置加载顺序；
  如果是依赖的问题，可以通过Maven/Gradle排除依赖中的配置文件：
  比如Maven中排除：

<dependency>
    <groupId>xxx</groupId>
    <artifactId>ocr-client</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <!-- 排除依赖中的application-int.properties -->
            <groupId>*</groupId>
            <artifactId>*</artifactId>
            <name>application-int.properties</name>
        </exclusion>
    </exclusions>
</dependency>

6. 验证配置类的扫描与激活 #

确认AppProp类被Spring正确扫描：

• 检查@EnableConfigurationProperties是否包含AppProp.class：

@EnableConfigurationProperties({AppProp.class, ClientProp.class})
@SpringBootApplication
public class BatchApplication {
public static void main(String[] args) {
SpringApplication.run(BatchApplication.class, args);
}
}

- 确认`AppProp`所在的包被`@SpringBootApplication`的扫描范围覆盖（默认扫描启动类所在包及子包）。

---

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