Spring Boot 多环境配置管理详解
多环境配置概述
在企业级应用开发中，通常需要面对多种运行环境，如本地开发（dev）、测试（test）、预发布（staging）和生产（prod）。不同环境下的数据库连接、日志级别、缓存策略等配置往往存在差异。若每次部署都手动修改配置，不仅效率低下，还容易引发错误。
Spring Boot 提供了灵活的多环境配置机制，通过分离配置文件并动态激活指定环境，实现"一次打包，多处运行"的目标。
配置结构设计
Spring Boot 支持 .properties 和 .yml 两种格式的配置文件。推荐使用 YAML 格式，因其结构清晰、层级分明，更适合复杂配置场景。
多环境配置命名规则如下：
# properties 风格
application.properties # 公共配置
application-dev.properties # 开发专用
application-test.properties # 测试专用
application-prod.properties # 生产专用
# yml 风格
application.yml
application-dev.yml
application-test.yml
application-prod.yml
主配置文件 application.yml 负责定义通用属性，并指定当前激活的环境。
配置拆分与激活流程
1. 创建独立的环境配置文件：
application-dev.yml：包含本地数据库、调试开关等application-test.yml：指向测试数据库，启用监控端点application-prod.yml：使用高安全性的数据源，关闭敏感接口
2. 在主配置中声明激活环境：
spring:
profiles:
active: prod
此时应用启动将自动加载 application-prod.yml 中的配置项。
开发与构建环境分离策略
理想情况下，开发者在 IDE 中使用 dev 环境进行调试，而构建系统生成的 JAR 包则默认运行在 prod 模式下。
以 IntelliJ IDEA 为例，可通过以下方式设置：
- 打开运行/调试配置（Run/Debug Configurations）
- 在 Environment variables 或 VM options 中添加：
-Dspring.profiles.active=dev
或在配置界面直接填写 Active Profiles 字段为 dev。
这样即使主配置中设定了 active: prod，本地运行时仍会优先使用开发环境配置。
构建阶段的环境控制
使用 Maven 打包时，也可通过命令行覆盖配置：
mvn clean package -Dspring-boot.run.profiles=prod
或者在 pom.xml 中结合 spring-boot-maven-plugin 设置默认激活环境。
配置继承与覆盖机制
Spring Boot 遵循"后加载覆盖先加载"原则：
- 公共配置写入
application.yml - 差异化配置分散至各环境专属文件
- 同名属性以激活环境的配置为准
例如：
# application.yml
server:
port: 8080
logging:
level:
root: INFO
---
# application-dev.yml
server:
port: 9090
spring:
datasource:
url: jdbc:mysql://localhost:3306/dev_db
当激活 dev 环境时，服务将监听 9090 端口，并连接本地开发数据库。
最佳实践建议
- 避免在代码中硬编码环境判断逻辑
- 利用
--spring.profiles.active参数实现部署灵活性 - 结合 CI/CD 工具，在流水线中自动注入环境变量
- 敏感信息应通过外部化配置（如环境变量、配置中心）注入
