Spring Boot子项目读取父项目配置文件而非自身配置的问题解决

数据老陈

2026-5-15

解决Spring Boot依赖项目读取主项目配置文件的问题

这个坑我之前踩过！本质是Spring Boot的classpath资源加载优先级在搞鬼——当项目B作为依赖被打包进项目A后，两个application.yml都在classpath的根目录下，Spring会优先加载**主项目（A）**的配置文件，直接覆盖了依赖（B）里的同名文件，所以你的LogSender才会读到A的配置。

给你几个实用的解决方案：

给依赖项目的配置文件重命名（最直接）
把项目B的application.yml改成独一无二的名字，比如application-obsp.yml，然后修改LogSender的注解：
```
@Configuration
@PropertySource("classpath:application-obsp.yml")
public class LogSender { }
```
这样两个配置文件名字不同，Spring就能精准找到B自己的配置，不会和A的混淆。
给依赖项目的配置文件单独建目录
把项目B的application.yml放到专属目录下，比如src/main/resources/config/b/，然后修改注解路径：
```
@Configuration
@PropertySource("classpath:config/b/application.yml")
public class LogSender { }
```
通过不同的classpath路径区分，避免根目录下的文件名冲突。
使用Spring Boot的配置属性绑定（更规范）
如果不想改文件名，还可以给B的配置加上专属前缀，比如在B的application.yml里写：
```
obsp:
  log:
    sender:
      # B的配置项
      url: xxx
      timeout: 3000
```
然后LogSender改用@ConfigurationProperties绑定，代替@PropertySource：
```
@Configuration
@ConfigurationProperties(prefix = "obsp.log.sender")
public class LogSender {
    // 声明对应配置项的字段，比如private String url; private int timeout;
    // 加上getter/setter
}
```
这种方式更符合Spring Boot的规范，还能避免配置文件冲突的问题，同时支持配置的自动补全和校验。