Spring Boot 多 Profile 配置详解

在实际开发中，我们常常需要根据不同环境（开发、测试、生产）配置不同的参数，例如数据库地址、服务端口、功能开关等。Spring Boot 为此提供了灵活的多 Profile 支持机制，帮助我们优雅地管理环境配置。

🧩 什么是 Profile

Spring Boot 的 Profile 是一种环境标签，用于加载对应的配置文件。你可以在 application.yml 或命令行中激活一个或多个 profile，从而实现环境隔离。

📝 基础配置方式

1. 主配置文件 `application.yml`

yaml 复制代码

spring:
  profiles:
    active: dev  # 指定当前激活的 profile

2. 环境特定配置文件

按照 Spring Boot 约定，可以为不同环境创建如下文件：

application-dev.yml
application-test.yml
application-prod.yml

例如：

yaml 复制代码

# application-dev.yml
server:
  port: 8080
logging:
  level:
    root: debug

yaml 复制代码

# application-prod.yml
server:
  port: 80
logging:
  level:
    root: info

Spring Boot 会根据激活的 Profile 自动加载并合并这些配置。

⚙️ 激活 Profile 的几种方式

✅ 1. 在 `application.yml` 中激活

yaml 复制代码

spring:
  profiles:
    active: dev

✅ 2. 使用命令行参数

bash 复制代码

java -jar app.jar --spring.profiles.active=prod

✅ 3. 设置环境变量

bash 复制代码

export SPRING_PROFILES_ACTIVE=prod

✅ 4. 在 IDE 中设置 VM options

ini 复制代码

-Dspring.profiles.active=prod

🧠 多 Profile 合并激活

Spring Boot 支持同时激活多个 profile，例如：

yaml 复制代码

spring:
  profiles:
    active:
      - dev
      - cn

此时，会依次加载：

application.yml
application-dev.yml
application-cn.yml

后加载的配置会覆盖前者。

🌐 区域化场景示例

yaml 复制代码

# application.yml
spring:
  profiles:
    active:
      - nonprod
      - cn

---
# application-nonprod.yml
feature-toggles:
  logging: true

---
# application-cn.yml
locale:
  region: China

你可以根据项目部署区域（如中国、欧洲）和环境（开发、测试、生产）灵活组合使用多个 profile。

✅ 使用 `@Profile` 注解加载 Bean

java 复制代码

@Configuration
@Profile("dev")
public class DevConfig {
    @Bean
    public DataSource dataSource() {
        // 返回开发环境的数据源
    }
}

✅ 使用 `spring.profiles.include` 引入子配置

yaml 复制代码

# application-cn.yml
spring:
  profiles:
    include: common

# application-common.yml
feature-toggles:
  new-feature: true

这样做可以复用通用配置，减少重复。

❗ 注意事项

多个 profile 激活时，后激活的配置会覆盖前者。
缩进必须用空格，不能使用 Tab。
Profile 配置中不要写错名称，否则不会生效。
可以通过 actuator 查看当前激活的 profile： /actuator/env

📌 总结

使用 application.yml 搭配多个 application-<profile>.yml 文件，能有效组织配置。
支持多方式激活 profile，灵活性强。
搭配 @Profile 注解实现按需加载 bean。
推荐为不同部署区域（如 -cn）建立区域 profile，提高配置复用性和可维护性。

通过合理运用多 profile 配置，我们能更高效地管理复杂项目环境，提升开发与运维体验。

Spring Boot 多 Profile 配置详解