
spring boot 默认仅对 application-*.properties 文件支持 profile 激活与属性覆盖,其他自定义配置文件(如 foo.properties、bar.properties)需通过 spring.config.name 显式声明,才能参与 profile 感知的加载与属性合并。
spring boot 默认仅对 application-*.properties 文件支持 profile 激活与属性覆盖,其他自定义配置文件(如 foo.properties、bar.properties)需通过 spring.config.name 显式声明,才能参与 profile 感知的加载与属性合并。
在 Spring Boot 中,Profile(如 demo)的属性覆盖机制默认只作用于以 application- 为前缀的配置文件(例如 application-demo.properties),而不会自动识别或加载 foo-demo.properties 或 bar-demo.properties。这是因为 Spring Boot 的配置加载器(ConfigDataLocationResolver)默认仅将 application 作为主配置名(config name),并据此查找 application-{profile}.properties;对于 foo.properties 这类非 application 命名的文件,即使存在 foo-demo.properties,它也不会被自动纳入 Profile 感知的加载链路中——即不会触发“默认文件 + profile 文件”的层级合并逻辑。
要使 foo.properties 和 foo-demo.properties(以及其他自定义配置文件)同样支持 Profile 覆盖,关键在于显式声明多个配置名,并确保它们均参与 Profile 感知加载。具体做法如下:
✅ 正确配置方式(推荐):
在启动时通过 JVM 参数指定多配置名,并激活目标 Profile:
java -Dspring.config.name=application,foo,bar \
-Dspring.profiles.active=demo \
-jar myapp.jar
此时 Spring Boot 会按顺序加载以下文件(按 Profile 激活规则):
-
application.properties→application-demo.properties(覆盖) -
foo.properties→foo-demo.properties(覆盖) -
bar.properties→bar-demo.properties(覆盖)
所有同名配置文件对均遵循“默认文件优先 + profile 文件覆盖”的语义,最终属性以最后加载的值为准(即 *-demo.properties 中的定义将覆盖 *.properties 中的同名项)。
⚠️ 注意事项:
-
spring.config.name必须用英文逗号,分隔,不可包含空格; - 配置文件必须位于
src/main/resources/(或 classpath 根路径)下,且命名严格匹配(如foo-demo.properties); - 若使用
@PropertySource手动加载foo.properties,则其不支持 Profile 感知,无法自动切换到foo-demo.properties,应避免混合使用; - Spring Boot 2.4+ 引入了新的 Config Data API,上述
spring.config.name方式仍完全兼容,是官方推荐的标准方案; - 如需在
application.properties中指定 profile(而非 JVM 参数),可写为spring.profiles.active=demo,但spring.config.name必须通过外部环境(JVM 参数、OS 环境变量或命令行参数)设置,不能在application.properties中定义——否则将导致循环依赖,启动失败。
? 小结:
无需重构为 @ConfigurationProperties 类或复制粘贴配置,也无需自定义 PropertySource。只需统一通过 spring.config.name 声明所有参与 Profile 覆盖的配置基名,并配合 spring.profiles.active,即可实现 foo.properties / foo-demo.properties 等任意命名配置文件的无缝 Profile 分层覆盖——简洁、标准、可维护。











