
Spring Boot 默认仅对 application-*.properties 支持 profile 激活与属性覆盖,其他自定义配置文件(如 foo.properties、bar.properties)不会自动按 profile 加载或覆盖。需通过 spring.config.name 显式声明多配置名,并配合 spring.profiles.active 实现统一 profile 控制。
spring boot 默认仅对 `application-*.properties` 支持 profile 激活与属性覆盖,其他自定义配置文件(如 `foo.properties`、`bar.properties`)不会自动按 profile 加载或覆盖。需通过 `spring.config.name` 显式声明多配置名,并配合 `spring.profiles.active` 实现统一 profile 控制。
在 Spring Boot 中,配置加载机制遵循严格的优先级与命名约定。默认情况下,只有以 application- 为前缀的配置文件(如 application-demo.properties)会被自动识别并按激活的 profile(如 demo)进行合并覆盖;而 foo.properties 和 foo-demo.properties 这类非 application- 开头的文件不会被 Spring Boot 的 profile 机制自动感知——即使存在 foo-demo.properties,它也不会作为 foo.properties 的 profile 变体被加载或用于属性覆盖。
要实现你期望的“每个基础配置文件(foo.properties、bar.properties)都支持对应 *-demo.properties 的 profile 覆盖”,关键在于将这些自定义配置文件纳入 Spring Boot 的主配置发现流程。Spring Boot 提供了 spring.config.name 属性,用于指定除默认 application 外还需加载的配置基名列表。
✅ 正确做法如下:
-
统一声明配置基名:通过 JVM 参数或环境变量设置
-Dspring.config.name=application,foo,bar
这会告诉 Spring Boot 同时加载
application.*、foo.*和bar.*三组配置文件(包括其 profile 变体)。 -
激活目标 profile:在
application.properties中指定spring.profiles.active=demo
或通过启动参数:
--spring.profiles.active=demo -
确保文件结构完整:
src/main/resources/ ├── application.properties # 基础通用配置 ├── application-demo.properties # demo profile 下 application 的覆盖项 ├── foo.properties # 基础 foo 配置 ├── foo-demo.properties # demo profile 下 foo 的覆盖项(将自动生效!) ├── bar.properties └── bar-demo.properties
此时 Spring Boot 会按以下顺序加载并合并属性(高优先级覆盖低优先级):
-
application.properties -
foo.properties -
bar.properties -
application-demo.properties -
foo-demo.properties← ✅ 现在会被识别并参与覆盖 -
bar-demo.properties← ✅ 同理
? 补充说明:
-
spring.config.name支持逗号分隔的多个名称,且顺序影响属性优先级(后声明的基名,其*-profile文件优先级更高)。建议保持application在前,自定义配置在后,以确保业务配置可被application-profile适度覆盖。 - 若使用 YAML,同理支持
foo.yml/foo-demo.yml,无需额外配置。 - 不推荐使用
@PropertySource手动加载foo-demo.properties:它不支持 profile 条件化,也无法参与 Spring Boot 的属性源层级管理,易导致覆盖逻辑混乱。
⚠️ 注意事项:
-
spring.config.name必须在应用启动早期(如 JVM 参数或bootstrap.properties)设置,运行时设置无效; - 所有
*-demo.properties文件必须与对应基础文件位于同一 classpath 目录下; - 属性覆盖遵循 Spring Boot 标准规则:后加载的同名属性覆盖先加载的,与文件名无关,只与加载顺序和来源优先级有关。
通过该方式,你无需拆分 profile 定义、无需重复复制配置,即可维持清晰的 基础文件 + profile 变体 结构,并获得一致、可预测的属性覆盖行为。


















