SpringBoot 多环境配置实战：从入门到生产，一文吃透切换与打包

小飞Coding
4 阅读10分钟

日常开发中，我们总会遇到这样的场景：开发环境用本地数据库、测试环境用测试数据库、生产环境用正式数据库，不同环境的端口、配置参数也各不相同。

如果每次切换环境都手动修改配置文件，不仅繁琐，还容易出错（比如把生产配置不小心提交到代码库）。

SpringBoot 早已内置了多环境配置解决方案，无需额外引入依赖，简单几步就能实现“一套代码，多环境适配”。本文结合实战场景，从基础用法到进阶技巧，再到生产级避坑，帮你彻底掌握 SpringBoot 多环境配置。

适合人群：SpringBoot 初学者、需要规范多环境开发的开发者，全文实战为主，案例可直接复制复用，贴合真实项目场景（如多环境数据源配置）。

一、核心认知：多环境配置的本质

SpringBoot 多环境配置的核心逻辑很简单：拆分配置文件，指定激活环境，自动合并配置。

核心原则：

  • 公共配置（所有环境共用，如项目名称、通用依赖配置）放在默认配置文件中；
  • 环境专属配置（如数据库地址、端口）放在对应环境的配置文件中；
  • 启动时指定环境，SpringBoot 会自动加载“公共配置 + 对应环境配置”，同名配置以环境配置为准（环境配置覆盖公共配置）。

结合我们之前的数据源场景举例：开发环境用 dev 数据库，测试用 test 数据库，生产用 prod 数据库，通过多环境配置，无需修改代码，仅切换环境就能实现数据源自动切换。

二、基础实现：3步搞定多环境配置（最标准）

这是企业开发中最常用、最规范的方式，无需复杂配置，新手也能快速上手。

Step 1：创建多环境配置文件

在 resources 目录下，创建以下 4 个配置文件（命名必须遵循 SpringBoot 规范：application-{env}.yml），结构如下：

resources/
 ├── application.yml         # 公共配置（所有环境共用）
 ├── application-dev.yml     # 开发环境配置（本地开发用）
 ├── application-test.yml    # 测试环境配置（测试服用）
 ├── application-prod.yml    # 生产环境配置（正式服用）

Step 2：编写公共配置（application.yml）

公共配置只写所有环境共用的内容，核心是指定“默认激活的环境”，避免每次启动都手动指定。

# 公共配置（所有环境共用）
spring:
  profiles:
    active: dev  # 默认激活开发环境（本地开发无需手动切换）
  application:
    name: multi-env-demo  # 项目名称（所有环境共用）

# 公共数据源配置（不同环境会覆盖同名配置）
app:
  datasource:
    username: root  # 假设所有环境用户名相同（不同可在对应环境重写）
    driver-class-name: com.mysql.cj.jdbc.Driver

Step 3：编写各环境专属配置

每个环境只写自己的专属配置，无需重复写公共配置，同名配置会覆盖公共配置。

1. 开发环境（application-dev.yml）

本地开发用，端口选 8080，数据库用本地或开发服数据库，配置宽松（方便调试）：

# 开发环境专属配置
server:
  port: 8080  # 开发环境端口

app:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb_dev?useSSL=false&serverTimezone=UTC
    password: 123456  # 开发环境密码（简单易记）
    backup-urls:  # 开发环境备份地址（本地测试用）
      - jdbc:mysql://localhost:3306/mydb_dev_backup1
      - jdbc:mysql://localhost:3306/mydb_dev_backup2

2. 测试环境（application-test.yml）

测试服专用，端口 8081，数据库用测试服地址，配置接近生产：

# 测试环境专属配置
server:
  port: 8081  # 测试环境端口

app:
  datasource:
    url: jdbc:mysql://test-db:3306/mydb_test?useSSL=false&serverTimezone=UTC
    password: test@123  # 测试环境密码（比开发环境复杂）
    backup-urls:
      - jdbc:mysql://test-backup1:3306/mydb_test_backup
      - jdbc:mysql://test-backup2:3306/mydb_test_backup

3. 生产环境（application-prod.yml）

正式服专用，端口 80（默认端口），数据库用生产服地址，配置严格（安全、性能优先）：

# 生产环境专属配置（安全、性能优先）
server:
  port: 80  # 生产环境默认端口
  tomcat:
    max-threads: 200  # 优化Tomcat线程数

app:
  datasource:
    url: jdbc:mysql://prod-db:3306/mydb_prod?useSSL=true&serverTimezone=UTC
    password: Prod@2026!  # 生产环境密码（复杂，定期更换）
    backup-urls:
      - jdbc:mysql://prod-backup1:3306/mydb_prod_backup
      - jdbc:mysql://prod-backup2:3306/mydb_prod_backup
    advanced-env-configs:  # 生产环境高级配置
      prod:
        timeout: 5000
        pool-size: 20

小技巧：生产环境的密码、密钥等敏感配置，不要直接写在配置文件中（后续进阶部分会讲如何安全管理）。

三、4种环境切换方式（覆盖所有场景）

配置文件建好后，如何切换环境？不同场景对应不同方式，优先推荐“启动命令指定”，灵活且不易出错。

方式1：配置文件写死（本地开发首选）

直接修改 application.yml 中的 spring.profiles.active，指定默认激活的环境：

spring:
  profiles:
    active: test  # 切换为测试环境

优点：简单，本地开发无需额外操作；缺点：切换环境需修改配置文件，不适合线上部署。

方式2：启动命令指定（最常用，线上部署首选）

打包成 jar 包后，启动时通过 --spring.profiles.active 指定环境，无需修改配置文件：

# 启动生产环境
java -jar multi-env-demo.jar --spring.profiles.active=prod

# 启动测试环境
java -jar multi-env-demo.jar --spring.profiles.active=test

优点：灵活，线上部署时可随时切换环境，无需重新打包；缺点：启动时需多写一段命令。

方式3：JVM 参数指定（-D 参数，兼容旧版本）

通过 -Dspring.profiles.active 传入 JVM 系统属性，优先级高于配置文件，适合临时切换环境：

# -D 参数指定生产环境，与命令行参数类似
java -Dspring.profiles.active=prod -jar multi-env-demo.jar

注意：-D 参数是 JVM 级别的，仅作用于当前 Java 进程，与我们之前讲的“-D 参数加载到 Environment”逻辑一致。

方式4：环境变量指定（Docker/K8s 部署必用）

在服务器或容器中设置环境变量 SPRING_PROFILES_ACTIVE，SpringBoot 会自动读取该环境变量，激活对应环境：

# Linux/Mac 设置环境变量
export SPRING_PROFILES_ACTIVE=prod
# 启动 jar 包（无需额外指定环境）
java -jar multi-env-demo.jar

# Windows 设置环境变量
set SPRING_PROFILES_ACTIVE=prod
java -jar multi-env-demo.jar

优点：适合容器化部署（Docker、K8s），可通过容器环境变量动态配置，无需修改启动命令；缺点：需要提前配置环境变量。

环境切换优先级（重要！）：命令行参数 > -D JVM 参数 > 环境变量 > 配置文件写死，同名配置按此优先级覆盖。

四、验证环境是否激活（快速排查问题）

切换环境后，如何确认当前激活的是目标环境？教你两种简单方法，新手也能快速验证。

方法1：通过 Environment 验证（推荐）

注入 Environment 对象，读取当前激活的环境，接口返回即可：

@RestController
@RequiredArgsConstructor
public class EnvCheckController {
    // 注入Environment，之前讲过它是配置的统一仓库
    private final Environment env;

    @GetMapping("/current-env")
    public String getCurrentEnv() {
        // 获取当前激活的环境（返回数组，支持多环境激活）
        String[] activeEnvs = env.getActiveProfiles();
        // 获取当前环境的数据源地址，进一步验证
        String dbUrl = env.getProperty("app.datasource.url");
        return "当前激活环境：" + Arrays.toString(activeEnvs) + "当前数据源：" + dbUrl;
    }
}

启动项目后，访问 http://localhost:端口/current-env，即可看到当前环境和对应的配置。

方法2：通过日志验证（最快捷）

SpringBoot 启动时，会在日志中打印当前激活的环境，搜索 Active profiles 即可找到：

2026-03-18 15:30:00.000  INFO 12345 --- [           main] c.example.multienv.MultiEnvDemoApplication  : The following 1 profile is active: "prod"

日志中明确显示 active: "prod"，说明当前激活的是生产环境。

五、进阶技巧：多环境与 @ConfigurationProperties 配合

结合我们之前讲的 @ConfigurationProperties 注解，多环境配置可以实现“配置自动绑定”，无需手动读取 Environment，代码更简洁、更规范。

核心：@ConfigurationProperties 会自动读取当前激活环境的配置，无需修改任何代码，切换环境即可自动适配。

实战案例（复用之前的数据源配置类）

// 配置绑定类，无需修改任何代码
@Component
@ConfigurationProperties(prefix = "app.datasource")
@Data // lombok简化getter/setter
public class DataSourceProperties {
    private String url;
    private String username;
    private String password;
    private List<String> backupUrls;
    private Map<String, AdvancedEnvConfig> advancedEnvConfigs;

    // 嵌套对象，对应生产环境的高级配置
    @Data
    public static class AdvancedEnvConfig {
        private Integer timeout;
        private Integer poolSize;
    }
}

使用时，直接注入该类即可，SpringBoot 会自动根据当前激活的环境，绑定对应环境的配置：

@RestController
@RequiredArgsConstructor
public class DataSourceController {
    private final DataSourceProperties dataSourceProperties;

    @GetMapping("/datasource")
    public DataSourceProperties getDataSourceConfig() {
        // 直接返回当前环境的数据源配置
        return dataSourceProperties;
    }
}

切换环境后，访问该接口，返回的配置会自动切换为对应环境的数据源信息，无需修改代码。

六、生产级优化：多环境打包与敏感配置管理

基础用法满足日常开发，但生产环境中，我们还需要解决两个问题：多环境打包（一套代码打不同环境的包）、敏感配置（密码、密钥）安全管理。

1. Maven 多环境打包（企业级常用）

通过 Maven 配置，实现“打包时指定环境，生成对应环境的 jar 包”，无需启动时手动指定环境，适合批量部署。

Step 1：修改 pom.xml，添加多环境配置

<profiles&gt;
    <!-- 开发环境 -->
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true&lt;/activeByDefault&gt;  <!-- 默认打包开发环境 -->
        </activation>
        <properties>
            <spring.profiles.active>dev</spring.profiles.active>
        </properties>
    </profile&gt;
    <!-- 测试环境 -->
    <profile>
        <id>test</id>
        <properties>
            <spring.profiles.active>test</spring.profiles.active>
        </properties>
    &lt;/profile&gt;
    <!-- 生产环境 -->
    <profile>
        <id>prod</id>
        <properties>
            <spring.profiles.active>prod</spring.profiles.active>
        </properties>
    </profile>
</profiles>

Step 2：打包命令（指定环境）

# 打包开发环境
mvn clean package -P dev

# 打包测试环境
mvn clean package -P test

# 打包生产环境
mvn clean package -P prod

打包后，jar 包中会自动激活对应环境，启动时无需再指定 spring.profiles.active，直接启动即可。

2. 敏感配置安全管理（生产必做）

生产环境中，密码、密钥等敏感配置，不能直接写在配置文件中（避免泄露），推荐两种常用方式：

方式1：命令行/环境变量传入（简单易操作）

# 启动时通过命令行传入敏感配置（覆盖配置文件中的值）
java -jar multi-env-demo.jar --spring.profiles.active=prod --app.datasource.password=Prod@2026!

方式2：配置中心管理（分布式项目首选）

集成 Nacos、Apollo 等配置中心，将敏感配置存储在配置中心，SpringBoot 启动时从配置中心拉取配置，无需在项目中存储敏感信息。

核心逻辑：配置中心的配置会加载到 Environment 中，@ConfigurationProperties 和 @Value 会自动读取，与本地配置无缝衔接。

七、常见避坑点（新手必看）

  • 配置文件命名错误：必须是 application-{env}.yml，不能少写 application-（比如写成 dev.yml，SpringBoot 无法识别）；
  • 环境切换优先级混淆：命令行参数优先级最高，若启动时指定了命令行参数，会覆盖配置文件和环境变量的设置；
  • 敏感配置泄露：生产环境不要把密码、密钥写在配置文件中，优先用命令行、环境变量或配置中心；
  • 多环境激活语法错误：SpringBoot 支持多环境同时激活（如 active: dev,test），但需注意配置冲突，同名配置以最后一个环境为准；
  • @ConfigurationProperties 不生效：忘记加 @Component 或 @EnableConfigurationProperties 注解，导致配置无法绑定。

八、终极总结（实战口诀）

记住这 4 句话，轻松搞定 SpringBoot 多环境配置：

  1. 建文件：application-{env}.yml，公共配置放默认；
  2. 写配置：环境专属配置只写差异，同名覆盖公共；
  3. 切环境：命令行最灵活，环境变量适配容器；
  4. 提安全：敏感配置不落地，配置中心更省心。

多环境配置是 SpringBoot 开发的基础，也是生产部署的必备技能，掌握本文的用法，能帮你规范开发流程、减少配置失误。

avatar
文章
阅读
粉丝