spring boot 16 - 技术栈

一、多环境开发的核心场景

在项目开发中，通常需要同时维护开发、测试、生产三套独立环境，它们的核心差异点包括：

数据库连接信息（URL、用户名、密码）
服务器端口、日志级别
第三方服务配置（如缓存、消息队列）
调试开关、安全策略

如果所有环境共用一套 application.yml，每次部署都需要手动修改配置，极易出错且难以维护。Spring Boot 的 Profiles 机制就是为了解决这个问题而生的。

二、基础用法：按环境拆分配置文件

1. 配置文件命名规则

Spring Boot 约定，多环境配置文件需遵循以下格式：

plaintext

复制代码

application-{profile}.yml

其中 {profile} 为环境标识，常见命名如下：

表格

环境	文件名	用途
开发环境	`application-dev.yml`	本地开发调试使用
测试环境	`application-test.yml`	测试服务器部署使用
生产环境	`application-pro.yml`	线上生产环境使用

2. 配置示例

application-dev.yml（开发环境）

yaml

复制代码

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/big_event
    username: root
    password: 1234
server:
  port: 8080

application-test.yml（测试环境）

yaml

复制代码

spring:
  datasource:
    url: jdbc:mysql://192.168.1.100:3306/big_event_test
    username: test_user
    password: test123
server:
  port: 8081

application-pro.yml（生产环境）

yaml

复制代码

spring:
  datasource:
    url: jdbc:mysql://10.0.0.5:3306/big_event_pro
    username: pro_user
    password: Pro@2024
server:
  port: 80

3. 激活指定环境

在主配置文件 application.yml 中，通过 spring.profiles.active 指定激活的环境：

yaml

复制代码

spring:
  profiles:
    active: dev  # 激活开发环境配置

启动项目时，Spring Boot 会自动加载 application.yml + application-dev.yml 的合并配置。

三、进阶用法：配置分组（Profiles Group）

除了按环境拆分，Spring Boot 还支持按配置类别分组，实现更细粒度的配置管理。

1. 分组配置文件示例

可以按配置的功能类别拆分文件，例如：

application-devServer.yml：服务器相关配置（端口、Tomcat 参数）

yaml

复制代码

server:
  port: 8080
  tomcat:
    max-threads: 200

application-devDB.yml：数据源相关配置

yaml

复制代码

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/big_event
    username: root
    password: 1234

application-devSelf.yml：自定义业务配置

yaml

复制代码

zyd:
  druid:
    username: zyd-druid
    password: zyd-druid

2. 在主配置中定义分组

在 application.yml 中，通过 spring.profiles.group 将多个配置文件归为一个组：

yaml

复制代码

spring:
  profiles:
    active: dev  # 激活dev分组
    group:
      "dev": devServer, devDB, devSelf  # dev分组包含三个配置文件

激活 dev 分组后，会同时加载这三个配置文件的内容，实现配置的模块化管理。

四、Profiles 的三种激活方式

1. 配置文件方式（最常用）

在 application.yml 中通过 spring.profiles.active 指定，适合本地开发调试。

2. 命令行参数方式

启动项目时，通过命令行参数指定激活的环境，优先级高于配置文件：

bash

运行

复制代码

# 激活测试环境
java -jar big-event-1.0-SNAPSHOT.jar --spring.profiles.active=test

# 激活自定义分组
java -jar big-event-1.0-SNAPSHOT.jar --spring.profiles.active=dev

3. 环境变量方式

通过操作系统环境变量指定，适合容器化部署（如 Docker）：

bash

运行

复制代码

# Linux/Mac
export SPRING_PROFILES_ACTIVE=pro

# Windows
set SPRING_PROFILES_ACTIVE=pro

五、配置生效的优先级说明

当多个配置文件存在相同配置项时，生效优先级从高到低为：

命令行参数 > 环境变量 > 配置文件中 spring.profiles.active 指定的配置
同一环境下，分组配置文件会覆盖主配置文件的同名配置
后加载的配置文件会覆盖先加载的配置项

六、补充：同文件内的多环境配置

除了拆分文件，还可以在单个 application.yml 中通过 --- 分隔不同环境的配置，适合简单场景：

yaml

复制代码

# 公共配置
spring:
  application:
    name: big-event

---
# 开发环境配置
spring:
  config:
    activate:
      on-profile: dev
  datasource:
    url: jdbc:mysql://localhost:3306/big_event

---
# 测试环境配置
spring:
  config:
    activate:
      on-profile: test
  datasource:
    url: jdbc:mysql://192.168.1.100:3306/big_event_test

同样通过 spring.profiles.active 指定激活的 on-profile 名称即可。

💡 最佳实践建议：

开发环境中，优先使用 application.yml + application-dev.yml 组合，方便本地调试。
生产环境部署时，使用命令行参数指定 pro 环境，避免修改配置文件。
复杂项目推荐使用配置分组，将服务器、数据源、自定义配置拆分管理，便于维护。