SpringBoot多环境配置详解：Dev、Test、Prod环境无缝切换

🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖DeepSeek-行业融合之万象视界(附实战案例详解100+)
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人

SpringBoot多环境配置详解：Dev、Test、Prod环境无缝切换

一、引言

在软件开发过程中，我们通常会有不同的运行环境，如开发环境（Dev）、测试环境（Test）和生产环境（Prod）。不同环境可能需要不同的配置，例如数据库连接信息、日志级别等。Spring Boot 提供了强大的多环境配置支持，能够让我们在不同环境之间实现无缝切换。本文将详细介绍如何在 Spring Boot 项目中实现多环境配置。

二、Spring Boot 多环境配置基础

2.1 配置文件命名规则

Spring Boot 支持使用不同的配置文件来管理不同环境的配置。配置文件的命名规则为 application-{profile}.properties 或 application-{profile}.yaml，其中 {profile} 表示环境名称，例如 dev、test、prod。

2.2 默认配置文件

Spring Boot 默认会加载 application.properties 或 application.yaml 作为全局配置文件。我们可以在这个文件中配置一些通用的属性，然后在不同环境的配置文件中覆盖这些属性。

2.3 激活指定环境

要激活指定的环境，我们可以通过以下几种方式：

• 命令行参数：在启动应用时，通过 --spring.profiles.active={profile} 参数指定要激活的环境。例如：

java -jar myapp.jar --spring.profiles.active=dev

• 系统属性：在代码中设置系统属性 spring.profiles.active。例如：

System.setProperty("spring.profiles.active", "dev");

• 配置文件：在 application.properties 或 application.yaml 中设置 spring.profiles.active 属性。例如：

spring.profiles.active=dev

三、使用 Properties 文件进行多环境配置

3.1 创建配置文件

首先，我们创建一个 Spring Boot 项目，然后在 src/main/resources 目录下创建以下配置文件：

• application.properties：全局配置文件
• application-dev.properties：开发环境配置文件
• application-test.properties：测试环境配置文件
• application-prod.properties：生产环境配置文件

3.2 编写配置内容

在 application.properties 中编写通用配置：

# 通用配置
server.port=8080

在 application-dev.properties 中编写开发环境特有的配置：

# 开发环境配置
spring.datasource.url=jdbc:mysql://localhost:3306/dev_db
spring.datasource.username=dev_user
spring.datasource.password=dev_password
logging.level.root=DEBUG

在 application-test.properties 中编写测试环境特有的配置：

# 测试环境配置
spring.datasource.url=jdbc:mysql://test-server:3306/test_db
spring.datasource.username=test_user
spring.datasource.password=test_password
logging.level.root=INFO

在 application-prod.properties 中编写生产环境特有的配置：

# 生产环境配置
spring.datasource.url=jdbc:mysql://prod-server:3306/prod_db
spring.datasource.username=prod_user
spring.datasource.password=prod_password
logging.level.root=WARN

3.3 激活指定环境

我们可以通过命令行参数激活开发环境：

java -jar myapp.jar --spring.profiles.active=dev

四、使用 YAML 文件进行多环境配置

4.1 创建配置文件

同样，在 src/main/resources 目录下创建以下 YAML 配置文件：

• application.yaml：全局配置文件
• application-dev.yaml：开发环境配置文件
• application-test.yaml：测试环境配置文件
• application-prod.yaml：生产环境配置文件

4.2 编写配置内容

在 application.yaml 中编写通用配置：

server:
  port: 8080

在 application-dev.yaml 中编写开发环境特有的配置：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dev_db
    username: dev_user
    password: dev_password
logging:
  level:
    root: DEBUG

在 application-test.yaml 中编写测试环境特有的配置：

spring:
  datasource:
    url: jdbc:mysql://test-server:3306/test_db
    username: test_user
    password: test_password
logging:
  level:
    root: INFO

在 application-prod.yaml 中编写生产环境特有的配置：

spring:
  datasource:
    url: jdbc:mysql://prod-server:3306/prod_db
    username: prod_user
    password: prod_password
logging:
  level:
    root: WARN

4.3 激活指定环境

可以在 application.yaml 中设置要激活的环境：

spring:
  profiles:
    active: dev

五、多环境配置的高级用法

5.1 配置文件继承

我们可以使用 spring.profiles.include 属性来实现配置文件的继承。例如，在 application-dev.yaml 中继承 application-common.yaml 的配置：

spring:
  profiles:
    include: common

5.2 条件配置

Spring Boot 支持根据条件加载不同的配置。例如，根据操作系统类型加载不同的配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;

@Configuration
public class AppConfig {

    @Bean
    @Profile("windows")
    public String windowsConfig() {
        return "Windows specific configuration";
    }

    @Bean
    @Profile("linux")
    public String linuxConfig() {
        return "Linux specific configuration";
    }
}

5.3 配置文件占位符

在配置文件中，我们可以使用占位符引用其他配置项。例如：

app.name=MyApp
app.title=${app.name} - Application

六、验证多环境配置

6.1 创建测试接口

我们创建一个简单的控制器来验证多环境配置是否生效：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConfigController {

    @Value("${spring.datasource.url}")
    private String datasourceUrl;

    @GetMapping("/config")
    public String getConfig() {
        return "Datasource URL: " + datasourceUrl;
    }
}

6.2 启动应用并测试

分别启动不同环境的应用，然后访问 /config 接口，验证返回的数据库连接信息是否与当前环境的配置一致。

七、总结

通过本文的介绍，我们了解了 Spring Boot 多环境配置的基本原理和使用方法。我们可以使用 Properties 或 YAML 文件来管理不同环境的配置，并通过多种方式激活指定的环境。同时，我们还介绍了多环境配置的高级用法，如配置文件继承、条件配置和配置文件占位符。掌握这些技巧，能够让我们在开发过程中更加高效地管理不同环境的配置，实现无缝切换。