Spring Boot Profile 多环境切换实战 —— 以 springboot-properties 为例（含踩坑）

Spring Boot Profile 多环境切换实战springboot-properties 踩坑记录Spring Boot Profile 多环境切换实战 —— 以 springboot-properties 为例含踩坑本文基于 springboot-learning-example 中的springboot-properties模块记录 Spring Boot 多环境Profile切换的几种方式、配置优先级以及运行测试时容易踩的两个坑。一、项目背景该模块演示用ConfigurationProperties绑定自定义配置并通过 Profile 区分开发dev与生产prod环境。启动类Application.java实现了CommandLineRunner启动时会打印HomePropertiesHelloWorldController在/返回 Hello,World!。二、Spring Boot Profile 是什么Profile 是 Spring 提供的「按环境隔离配置」的机制。核心约定主配置文件application.properties环境专属文件application-{profile}.properties如application-dev.properties、application-prod.properties通过spring.profiles.active指定激活哪个环境三、本项目的多环境配置application.properties主指定激活环境# Spring Profiles Active spring.profiles.activeprodapplication-dev.properties开发环境## 家乡属性 Dev home.provinceZheJiang home.cityWenLing home.descdev: Im living in ${home.province} ${home.city}.application-prod.properties生产环境## 家乡属性 Prod home.provinceZheJiang home.cityWenLing home.descprod: Im living in ${home.province} ${home.city}.dev 与 prod 仅home.desc前缀不同dev:/prod:这正是用来验证当前激活环境的「标记」。四、4 种切换环境的方式优先级高 → 低命令行参数 / 环境变量 主配置文件 默认值。下面 4 种方式任选其一即可。方式 1修改主配置文件最常用随代码提交# application.properties spring.profiles.activedev # 改成 dev / prod 即可方式 2运行 Jar 时传命令行参数不改动文件推荐部署用java -jar target/springboot-properties-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod方式 3Maven 插件启动时指定开发调试用mvn spring-boot:run -Dspring-boot.run.profilesprod方式 4环境变量容器 / 服务器部署最常用# Linux / macOS export SPRING_PROFILES_ACTIVEprod # Windows set SPRING_PROFILES_ACTIVEprod五、优先级速查表方式示例优先级适用场景命令行参数--spring.profiles.activeprod最高临时验证、部署环境变量SPRING_PROFILES_ACTIVEprod高Docker / K8s主配置文件spring.profiles.activeprod中随代码固定默认值无最低兜底提示高优先级的配置会「覆盖」低优先级所以命令行/环境变量设了 prod就算文件里写 dev 也会生效 prod。六、如何验证当前环境生效启动应用后看两处控制台打印的HomeProperties中desc字段 —— 带dev:还是prod:前缀。或浏览器访问http://localhost:8080/确认接口正常返回。HomeProperties{provinceZheJiang, cityWenLing, descprod: Im living in ZheJiang WenLing.}七、附运行测试时的两个隐藏坑坑 Amvn test测试被悄悄跳过pom 里maven-surefire-plugin写死了skipTeststrue/skipTests。这个值是写在configuration里的字面量命令行-DskipTestsfalse根本覆盖不了导致测试一直被跳过。解决把 pom 中skipTests改为false。坑 B运行 SpringBootTest 报 NoSuchMethodErrorpom 里硬编码了spring-boot-test:1.4.2.RELEASE与父依赖spring-boot 2.1.3.RELEASE冲突运行时抛NoSuchMethodError: SpringApplication.init(java.lang.Object[])。解决删除这个冗余依赖spring-boot-starter-test已经带正确版本。修复后运行单个测试方法的命令cd springboot-properties mvn test -DtestPropertiesTest#getHomeProperties八、总结切换环境本质就是改spring.profiles.active4 种方式按场景选。优先级记住一句话命令行 环境变量 配置文件。用home.desc前缀这个「标记」快速验证环境是否真的切换成功。跑测试前先确认 pom 没把skipTests写死、没引冲突的老版本依赖。