spring.profiles.active必须在Spring Boot启动前生效，最稳妥方式是启动命令指定或application.yml顶层配置；Maven Profile与Spring Profile无关，需手动桥接；文件名须为application-{profile}.yml；多profile激活时后声明者优先；Bean需支持profile-aware才能动态刷新。

Spring Boot 的 spring.profiles.active 怎么设才生效

它不是写在哪都管用，必须在 Spring Boot 启动前就加载到环境里。常见错误是只改了 application.properties 里的值，但没传给启动上下文。

• 最稳妥的方式是在启动命令里加：java -jar app.jar --spring.profiles.active=prod
• 或在 application.yml 顶层写（注意缩进）：

  spring:
    profiles:
      active: dev

• 如果用了 Maven 构建，别指望 mvn spring-boot:run -Dspring.profiles.active=test 能直接透传——得配合 spring-boot-maven-plugin 的 environmentVariables 配置，否则 JVM 参数不进 Spring 上下文

Maven Profile 和 Spring Profile 是两套东西，别混着用

很多人以为在 pom.xml 里激活 <profile><id>prod</id></profile>，Spring 就自动切到 prod 环境，其实不会。Maven Profile 控制的是构建时资源过滤、依赖开关；Spring Profile 控制的是运行时 Bean 加载逻辑。

• Maven 激活 prod profile 后，可以自动把 src/main/resources/application-prod.yml 复制进 jar，但是否加载它，仍取决于 spring.profiles.active 的值
• 想联动？得手动桥接：在 pom.xml 里用 resources + filters 把 Maven 属性注入到配置文件中，比如写 spring.profiles.active=@activatedProperties@，再配 <properties><activatedproperties>dev</activatedproperties></properties>
• 注意：Maven 的 activeByDefault 不会覆盖命令行传入的 -P，但 Spring 的 spring.profiles.default 会被 active 覆盖，优先级要理清

多环境配置文件命名和加载顺序容易踩坑

Spring Boot 对文件名敏感，application-dev.yml 可以被识别，但 application-development.yml 不会自动匹配，除非你显式指定 spring.profiles.active=development。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 有效命名规则只有两种：application-{profile}.yml 或 application-{profile}.properties，中间不能有下划线或额外单词
• 加载顺序是：application.yml → application-{profile}.yml，后者覆盖前者同名属性；但多个 profile 同时激活时（如 dev,mysql），后声明的 profile 文件优先级更高
• 别在 application.yml 里写 spring.profiles.include 来“导入”其他 profile——它只在当前文件解析阶段起作用，且不能递归包含，容易漏掉配置

Profile 切换后数据库连接池、Redis 连接等常不刷新

这些 Bean 默认是单例且非懒加载，Spring 在容器启动时就初始化好了。Profile 切了，但已创建的 Bean 不会重建，导致连的还是旧环境的库。

立即学习“Java免费学习笔记（深入）”；

• 解决方案不是重启应用，而是让关键 Bean 支持 profile-aware：用 @Profile("prod") 注解类，或用 @ConditionalOnProperty(name = "spring.profiles.active", havingValue = "prod")
• 更实用的做法是把数据源配置抽成 @ConfigurationProperties(prefix = "spring.datasource") 类，配合不同 profile 下的 spring.datasource.url 值，这样 Spring Boot 自动重建 DataSource Bean
• 注意：HikariCP 的 spring.datasource.hikari.* 配置项，在 profile 切换后必须完整重复定义，不能只写差异项——它不会继承父配置

实际项目里最麻烦的不是怎么配，而是配置分散在 pom.xml、application.yml、JVM 参数、IDE 运行配置里，稍不注意就有一处没同步。每次上线前最好 grep 一遍 spring.profiles.active 和 profiles 相关字段，确认所有入口点一致。