Spring Boot多环境配置的核心只用记住一件事：用spring.profiles.active指定当前环境，把差异参数分散到application-{profile}.yml文件里。
很多Java项目在本地跑得好好的,一到测试服务器就数据库连不上，一到生产就Redis地址写错，根本原因不是代码问题，而是把所有环境配置揉在一个文件里，每次上线前手动改，Spring Boot的profile机制就是为这种场景设计的。
springboot多环境配置yml怎么做：从零开始搭骨架
先别急着写代码,把配置文件目录理清楚，假如你的项目同时面对开发、测试、生产三套环境，就在src/main/resources下创建四个文件：
application.yml：主配置，放公共参数和激活哪个环境application-dev.yml：开发环境，连本地数据库application-test.yml：测试环境，连内网测试库application-prod.yml：生产环境，连正式数据库
主文件里这样写：
spring:
application:
name: order-service
profiles:
active: dev
application-dev.yml里写数据库连接：
spring:
datasource:
url: jdbc:mysql://localhost:3306/order_dev
username: dev_user
password: dev_pass
启动项目后,Spring Boot会把application.yml和application-dev.yml合并加载，如果两边有同一个key，环境文件优先，这就是多环境配置最基础也最常用的方式。
用命令行切换环境：不用改代码
开发时激活dev,测试时激活test，生产时激活prod，不一定改主文件，更灵活的做法是命令行传参：
java -jar order-service.jar --spring.profiles.active=prod
Maven方式运行：
mvn spring-boot:run -Dspring-boot.run.profiles=test
在IDEA里,可以在Run/Debug Configurations的Program arguments里加--spring.profiles.active=dev，也可以加到VM options里用-Dspring.profiles.active=dev，同一个jar包扔到不同服务器，启动命令改一个参数就行，不需要重新打包。
springboot多环境配置properties和yml区别：选型别太纠结
很多入门同学会卡在选.properties还是.yml上，其实两者都能完成多环境配置，差异主要在设计习惯。
| 对比项 | yml | properties |
|---|---|---|
| 层级表达 | 缩进嵌套，结构清晰 | 扁平键值，前缀重复 |
| 列表支持 | 原生支持列表 | 需要list[0]=写法 |
| 中文支持 | 同样需要转码 | 同样需要转码 |
| 团队接受度 | 新项目常用 | 老项目常见 |
例如同样配置数据库：
spring.datasource.url=jdbc:mysql://localhost:3306/order_dev spring.datasource.username=dev_user spring.datasource.password=dev_pass
行业共识认为,国内新起的Spring Boot项目使用yml格式的比例相对更高，但如果你接手的老代码全是properties，完全没必要为了统一格式去迁移，重点是profile机制，不是文件后缀。
springboot项目多环境配置实战：数据库和Redis这样管
实际项目中,不同环境差异最大的就是数据库、Redis、消息队列、日志级别这些，把公共参数抽到主配置，把差异参数放进各环境文件，是工程化里最干净的做法。
开发环境：
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/order_dev
redis:
host: 127.0.0.1
port: 6379
logging:
level:
com.example.order: debug
生产环境：
spring:
datasource:
url: jdbc:mysql://prod-db.internal:3306/order_prod
redis:
host: prod-redis.internal
port: 6379
logging:
level:
com.example.order: info
如果数据库密码不能明文写在配置文件里,Spring Boot支持占位符加环境变量：
spring:
datasource:
password: ${DB_PASSWORD}
启动时通过系统环境变量DB_PASSWORD
传入真实密码，国内多数云平台和容器编排系统都支持在部署配置里注入环境变量，这样生产配置就不会泄露在代码仓库里。
本地开发环境与云服务器部署springboot多环境配置怎么配合
假设你在北京本地开发,测试服务器在华北地域某云厂商，生产服务器独立部署，本地用dev，云服务器用test或prod，云服务器上通常用启动脚本固定profile：
nohup java -jar order-service.jar --spring.profiles.active=prod > app.log 2>&1 &
如果使用systemd管理服务,服务文件里加上：
[Service] Environment=SPRING_PROFILES_ACTIVE=prod ExecStart=/usr/bin/java -jar /opt/order-service.jar
这样开机自启也会带上prod环境,不同地域服务器之间切换，只需要改启动脚本里的profile值，代码和jar包完全不变，近年来，随着容器化部署普及，很多团队也把profile信息放进了Kubernetes的ConfigMap或Deployment环境变量里，但核心思路和本地启动脚本一致。
springboot多环境配置不生效怎么办：按这三个方向排查
多环境配置不生效是新手问得比较多的一个问题,大多数情况不是Spring Boot挂了，而是文件命名或打包环节出了小差错。
第一步,检查文件名。application-dev.yml的dev必须和spring.profiles.active的值完全一致，大小写敏感，有人写成application-dev.yaml，主文件里却用dev，默认约定是application-{profile}.yml，后缀不统一可能不被识别。
第二步,启动日志确认，启动项目时搜日志里的The following profiles are active，后面会显示真正激活的profile，如果显示为空，说明没读到主文件里的激活配置，或者被更高优先级的配置覆盖了。
第三步,检查打包产物，Maven打包后看target/classes下有没有对应环境的yml文件，有些项目配置了maven-resources-plugin的过滤规则，可能把application-dev.yml过滤掉，或者把占位符替换成空值，业内专家指出，多环境配置不生效的场景里，文件名拼写和资源过滤是两个高频根因。
另一个隐蔽点是,如果你用了Spring Cloud，bootstrap.yml的加载优先级高于application.yml，激活profile的配置写在bootstrap.yml里可能更早生效，但纯Spring Boot项目不用管这个。
springboot多环境配置收费吗：开源免费，别被概念绕进去
这个问题常见于刚接触微服务的企业负责人或开发者,Spring Boot本身是Apache 2.0开源协议，profile机制、多环境配置、命令行传参这些能力完全免费，不需要购买任何商业授权。
市面上一部分“微服务脚手架”“低代码平台”收费，是因为它们封装了额外功能或提供技术支持，不是Spring Boot本身收费，企业自己搭建Spring Boot项目，用多环境配置，不涉及授权费用，真正花钱的是云服务器、数据库、负载均衡这些基础设施资源。
springboot多环境配置常见问题解答
springboot多环境配置多个yml文件怎么同时加载？
Spring Boot支持同时激活多个profile，例如spring.profiles.active=dev,local，多个环境文件都会加载，后出现的profile中的配置会覆盖先出现的相同key，适合组合基础环境和本地临时环境。
springboot多环境配置不生效和maven打包有关系吗？
有关系,Maven打包时如果启用了资源过滤，可能破坏yml文件的占位符或过滤掉配置文件，检查target/classes目录下是否有完整的application-dev.yml是否被过滤插件改写，打包插件版本过低也可能导致资源配置未包含。
springboot多环境配置可以用命令行传参覆盖数据库密码吗？
可以,启动命令加--spring.datasource.password=新密码，或者设置环境变量SPRING_DATASOURCE_PASSWORD，命令行参数优先级高于配置文件中的同名key，所以能直接覆盖，Spring Boot的配置优先级从高到低依次是命令行参数、系统环境变量、配置文件、默认值。
多环境配置是Spring Boot工程化的第一课，也是项目从本地走向测试和生产必须迈过的一步，把profile机制吃透，配合启动参数和环境变量，同一套代码就能在不同环境里稳定切换，不需要每次上线都改配置改到心慌。