SpringBoot如何实现外部配置文件部分覆盖类路径自定义配置

问题根因 #

Spring Boot 2.4版本之后对配置加载逻辑做了调整，当你用spring.config.location显式指定多个独立的配置文件时，默认不会自动触发跨文件的属性合并，只有全量匹配结构的配置才会生效，就会出现你遇到的部分覆盖不生效的问题。Spring Boot本身默认支持高优先级配置仅覆盖指定项、未配置项自动合并继承低优先级配置的能力，调整配置写法即可实现需求。

解决方案 #

方案1：使用spring.config.additional-location附加外部配置（最推荐）

spring.config.location会完全替换Spring Boot默认的配置搜索路径，而spring.config.additional-location是在原有配置路径基础上额外添加配置源，且额外添加的配置源优先级高于默认的类路径配置，会自动触发合并覆盖逻辑。
启动命令修改为如下写法即可：

java -Dspring.config.name=application-config -Dspring.config.additional-location=file:///D:/test/application-config-override.yaml -jar myapp.jar

此处指定spring.config.name=application-config是为了让Spring Boot默认识别类路径下的application-config.yaml作为基础配置文件，不需要再显式写到配置路径里。

方案2：统一配置文件名+指定配置搜索路径

你可以把外部配置文件重命名为和类路径配置文件同名的application-config.yaml，放到D:/test/目录下，然后用如下命令启动：

java -Dspring.config.name=application-config -Dspring.config.location=classpath:,file:///D:/test/ -jar myapp.jar

这种写法下，Spring Boot会按配置路径的顺序先后搜索application-config.yaml，后面路径（外部目录）下的配置优先级更高，会自动覆盖同名属性，缺省的属性自动继承类路径下的配置。

方案3：兼容旧版配置处理逻辑

如果你一定要保留原来的两个不同名的配置文件，可以在启动命令里加上spring.config.use-legacy-processing=true关闭2.4版本之后引入的新配置处理逻辑，沿用旧版本的合并规则：

java -Dspring.config.use-legacy-processing=true -Dspring.config.location=classpath:application-config.yaml,file:///D:/test/application-config-override.yaml -jar myapp.jar

这个参数适配你当前的配置路径写法，可以正常触发部分覆盖的合并逻辑。

内容的提问来源于stack exchange，提问作者Zaw Than oo