关键词：Spring Boot、多环境配置、application.yml、profile、dev、test、prod
✅ 摘要
在实际项目开发中，我们通常需要为不同的运行环境（如开发、测试、生产）配置不同的参数。Spring Boot 提供了强大的多环境配置支持机制 ，通过 application-{profile}.yml 或 application-{profile}.properties 文件，我们可以轻松实现不同环境下的差异化配置。
本文将围绕以下内容进行详细讲解：
- Spring Boot 多环境配置原理
- 如何创建与使用 application-dev.yml、application-test.yml、application-prod.yml
- 通过
spring.profiles.active指定当前激活的环境 - 使用
@Profile注解控制 Bean 的加载 - 在 Maven/Gradle 构建时动态替换配置文件
- 部署时如何灵活切换环境配置（JVM 参数、Docker、K8s）
每部分都配有 完整的 YAML 配置文件和 Java 示例代码。
📌 一、Spring Boot 多环境配置原理
🔹 1. 核心机制：Profile 概念
Spring Boot 允许我们为不同的环境定义多个配置文件，每个文件对应一个 profile，例如：
application-dev.yml（开发环境）application-test.yml（测试环境）application-prod.yml（生产环境）
通过设置 spring.profiles.active=xxx 来指定当前使用的环境配置。
🔹 2. 默认配置文件：application.yml
这个文件是通用配置，无论哪个环境都会被加载。如果某个 profile 文件中也定义了相同属性，则会覆盖默认配置。
📌 二、创建与使用多环境配置文件
🔹 1. 目录结构示例（resources 下）
src/
└── main/
└── resources/
├── application.yml
├── application-dev.yml
├── application-test.yml
└── application-prod.yml🔹 2. application.yml（通用配置）
yaml
server:
port: 8080
spring:
application:
name: springboot-multi-env🔹 3. application-dev.yml（开发环境）
yaml
spring:
datasource:
url: jdbc:mysql://localhost:3306/dev_db?useSSL=false&serverTimezone=UTC
username: root
password: dev_password
driver-class-name: com.mysql.cj.jdbc.Driver🔹 4. application-test.yml（测试环境）
yaml
spring:
datasource:
url: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC
username: test_user
password: test_password
driver-class-name: com.mysql.cj.jdbc.Driver🔹 5. application-prod.yml（生产环境）
yaml
spring:
datasource:
url: jdbc:mysql://db.prod.example.com:3306/prod_db?useSSL=false&serverTimezone=UTC
username: prod_user
password: prod_secure_password
driver-class-name: com.mysql.cj.jdbc.Driver📌 三、激活特定环境配置
🔹 1. 方式一：在 application.yml 中直接指定
yaml
spring:
profiles:
active: dev🔹 2. 方式二：启动命令行参数（优先级更高）
bash
java -jar yourapp.jar --spring.profiles.active=test🔹 3. 方式三：JVM 启动参数
bash
java -Dspring.profiles.active=prod -jar yourapp.jar🔹 4. 方式四：Docker 部署时指定
dockerfile
CMD java -Dspring.profiles.active=prod -jar /app.jar🔹 5. 方式五：Kubernetes 部署时指定
yaml
env:
- name: SPRING_PROFILES_ACTIVE
value: "prod"📌 四、结合 @Profile 控制 Bean 加载
你可以使用 @Profile("dev") 注解来控制某些 Bean 是否加载。
示例：根据环境加载不同的数据源配置
java
@Component
@Profile("dev")
public class DevDataSourceConfig {
public DevDataSourceConfig() {
System.out.println("加载【开发环境】数据源配置");
}
}
@Component
@Profile("prod")
public class ProdDataSourceConfig {
public ProdDataSourceConfig() {
System.out.println("加载【生产环境】数据源配置");
}
}📌 五、Maven 构建时动态替换配置（可选）
如果你希望在构建阶段就指定环境，可以结合 Maven 的 profile 实现资源过滤。
🔹 1. pom.xml 配置多个 profile
xml
<profiles>
<profile>
<id>dev</id>
<properties>
<activatedProperties>dev</activatedProperties>
</properties>
</profile>
<profile>
<id>prod</id>
<properties>
<activatedProperties>prod</activatedProperties>
</properties>
</profile>
</profiles>🔹 2. 资源过滤配置
xml
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
</build>🔹 3. 构建命令
bash
mvn clean package -Pprod📌 六、常见问题与解决方案
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 启动时报错找不到数据库连接 | 没有正确激活 profile | 查看日志确认 spring.profiles.active 设置 |
| application.yml 和 application-dev.yml 冲突 | 属性冲突 | 优先级：命令行 > JVM > profile 文件 > 默认文件 |
| Docker/K8s 环境未生效 | 未传递环境变量 | 检查容器启动参数或 K8s ConfigMap |
✅ 总结
通过本文的学习，你应该已经掌握了以下内容：
| 模块 | 技能点 |
|---|---|
| 多环境配置原理 | Profile 概念与加载顺序 |
| 配置文件命名规范 | application-dev.yml 等 |
| 激活方式 | application.yml、命令行、JVM、Docker、K8s |
| Bean 动态加载 | 使用 @Profile 控制组件加载 |
| 构建时配置 | 结合 Maven 实现打包前环境选择 |
| 生产部署技巧 | 如何安全地切换环境配置 |
这些技能是你构建企业级 Spring Boot 微服务系统的重要基础。