Spring Boot 3.0 起废弃 spring.profiles，必须改用 spring.config.activate.on-profile；同时需注意 spring.profiles.active 与 on-profile 不可共存于同一配置块，否则启动报错。

spring boot 3.0 起废弃 `spring.profiles`，必须改用 `spring.config.activate.on-profile`；同时需注意 `spring.profiles.active` 与 `on-profile` 不可共存于同一配置块，否则启动报错。

Spring Boot 3.0 对配置文件的解析机制进行了重大重构，核心变化之一是彻底移除了 YAML/Properties 中直接使用 spring.profiles（如 profiles: dev）的语法支持。该属性自 2.4 版本起已被标记为弃用，至 3.0 正式删除——即使启用了 spring.config.use-legacy-processing: true，该兼容开关仅适用于旧版配置加载逻辑的底层行为（如 profile 激活顺序、文件定位等），并不恢复对已删除属性的语法解析。因此，InvalidConfigDataPropertyException 报错无法通过开启 legacy 模式规避，必须进行显式迁移。

✅ 正确迁移方式

需将所有 spring.profiles: xxx 形式的配置块头部，替换为标准的 spring.config.activate.on-profile: xxx 结构，并确保其嵌套层级准确：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

# application.yml
spring:
  profiles.active: dev  # ✅ 全局激活 profile 仍合法（仅此处允许）
  rails:
    url: https://dev-rails.example.com
    userIdentifier: DEV_USER
    service: FILESERVICE
    methodInBody: POST
    uri: /api/external-interfaces/file-locations

---
spring:
  config:
    activate:
      on-profile: stage  # ✅ 替换原 'profiles: stage'
  rails:
    url: https://stage-rails.example.com
    userIdentifier: STAGE_USER
    service: FILESERVICE
    methodInBody: POST
    uri: /api/external-interfaces/file-locations
  jackson:
    serialization:
      indent-output: true

---
spring:
  config:
    activate:
      on-profile: prod   # ✅ 替换原 'profiles: prod'
  rails:
    url: https://prod-rails.example.com
    userIdentifier: PROD_USER
    service: FILESERVICE
    methodInBody: POST
    uri: /api/external-interfaces/file-locations

⚠️ 关键注意事项

• 禁止混用：spring.profiles.active（全局激活）可单独存在，但任何包含 spring.config.activate.on-profile 的配置片段中，绝对不可再出现 spring.profiles: xxx 或 profiles: xxx，否则 Spring Boot 会拒绝加载并抛出 InvalidConfigDataPropertyException。
• 层级严格：on-profile 必须位于 spring.config.activate 下，缩进必须正确（YAML 对空格敏感），错误写法如 spring.config.activate.on-profile: dev（顶格）或缩进不一致均会导致解析失败。
• 多 profile 激活：若需匹配多个 profile（如 dev 或 test），可使用 SpEL 表达式：

  spring:
    config:
      activate:
        on-profile: "dev | test"

• 条件组合：支持与 on-environment 等联合使用，实现更精细的配置激活策略。

? 验证建议

升级后务必执行以下检查：

1. 运行 mvn spring-boot:run 或启动应用，确认无 InvalidConfigDataPropertyException；
2. 通过 /actuator/env 端点验证当前激活的 profile 及对应配置是否正确注入；
3. 对涉及 profile 切换的功能（如数据库连接、外部服务地址）进行集成测试。

完成上述迁移后，配置即完全符合 Spring Boot 3.x 规范，兼顾可维护性与未来版本兼容性。