Spring Boot 应用程序在不同运行场景下需要动态切换配置参数。通过 Profile 机制可高效管理多环境配置，避免手动修改配置导致的错误。本文深入解析多环境配置实现方式、加载机制及优先级规则。

Profile 机制核心原理

开发过程中通常存在开发（dev）、测试（test）、生产（prod）三种环境：

• 开发环境：连接本地数据库，开启详细日志
• 测试环境：对接测试服务器资源，供质量团队验证
• 生产环境：部署至云端，使用线上数据库，关闭调试日志

Profile 机制通过环境标识自动加载对应配置，实现一键切换环境。

分离式配置方案（推荐）

将不同环境配置拆分为独立文件，命名遵循 application-{profile}.properties/yml 规范：

resources/
├── application.properties
├── application-dev.properties
├── application-test.properties
└── application-prod.properties

properties 格式示例

主配置文件指定激活环境：

spring.profiles.active=staging

环境专属配置文件示例：

# application-staging.properties
server.port=9001
spring.datasource.url=jdbc:mysql://test-db:3306/staging_db

yml 格式示例

主配置文件：

spring:
  profiles:
    active: production

生产环境配置：

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/main_db

单文件多文档块配置

yml 支持使用 --- 分隔多环境配置：

server:
  port: 9001
spring:
  config:
    activate:
      on-profile: staging
---
server:
  port: 9002
spring:
  config:
    activate:
      on-profile: production
---
server:
  port: 9003
spring:
  config:
    activate:
      on-profile: local

启动时通过 -Dspring.profiles.active=production 指定环境，系统将加载对应端口配置。

Profile 激活方式优先级

激活方式按优先级从高到低排列：

1. JVM 参数： -Dspring.profiles.active=prod
2. 命令行参数： --spring.profiles.active=prod
3. 主配置文件内指定： spring.profiles.active=prod

配置文件加载位置优先级

Spring Boot 按以下顺序扫描配置文件，高优先级配置覆盖低优先级同名项：

1. 项目根目录下的 config 子目录（file:./config/）
2. 项目根目录（file:./）
3. 资源目录下的 config 子目录（classpath:/config/）
4. 资源根目录（classpath:/）

所有位置配置会合并生效，不同配置项互不覆盖。

配置方案对比