SpringBoot配置文件切换的全面指南

SpringBoot 提供了灵活的配置管理机制，支持通过配置文件、命令行参数、环境变量等方式来指定当前使用的环境。以下是详细的配置文件切换指南：

一、配置文件命名规则

Spring Boot 的配置文件共有两种形式：.properties 文件和 .yml 文件。不管哪种形式，它们都能通过文件名的命名形式区分出不同的环境配置。文件命名格式为：application-{profile}.properties/yml，其中 {profile} 一般为各个环境的名称或简称，例如 dev（开发环境）、test（测试环境）和 prod（生产环境）等。

二、激活 Profile 的方式

1. 通过命令行参数指定环境在启动应用时，可以通过命令行参数指定环境。例如：

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

1. 这会覆盖 application.yml 中的默认配置，使用 application-prod.yml 作为配置文件。
2. 通过设置环境变量指定环境可以通过设置环境变量 SPRING_PROFILES_ACTIVE 来指定环境。例如：

export SPRING_PROFILES_ACTIVE=prod

1. 这种方式适合在部署到服务器时使用，尤其是在 Docker 或 Kubernetes 等容器化环境中。
2. 在 IDE 中配置环境如果你在 IDE（如 IntelliJ IDEA 或 Eclipse）中运行 Spring Boot 应用，可以通过运行配置指定环境。例如，在 IntelliJ IDEA 中，打开运行配置（Run/Debug Configurations），在 “Program arguments” 或 “Environment variables” 中添加相应的配置。
3. 在配置文件中激活环境在 application.yml 中，可以通过 spring.profiles.active 属性指定默认的环境。例如：

spring:
  profiles:
    active: dev  # 默认使用开发环境

1. 当启动应用时，如果没有指定其他环境，Spring Boot 会自动加载 application-dev.yml 作为配置文件。

三、多环境配置文件管理

1. 创建多个配置文件在 src/main/resources 目录下创建多个配置文件，例如：
   • application.yml（通用配置）
   • application-dev.yml（开发环境配置）
   • application-test.yml（测试环境配置）
   • application-prod.yml（生产环境配置）
2. 配置文件的加载顺序Spring Boot 会按照以下顺序加载配置文件：
   • 项目根目录下的 config 目录
   • 项目根目录
   • classpath 下的 config 目录
   • classpath 目录（新建项目时 application.properties 默认所在位置）
   配置文件加载顺序和优先级顺序相反，优先级低的先加载。如果有重复的配置，先加载的配置文件会被覆盖。
3. 通用配置与环境特定配置将通用的配置（如应用名称、日志格式等）放在 application.yml 中。将环境特定的配置（如数据库连接、端口号等）放在 application-{profile}.yml 中。

四、使用示例

以下是一个简单的示例，展示如何在不同环境下切换配置文件：

示例配置文件

• application.yml：

spring:
  application:
    name: myapp

• application-dev.yml：

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dev_db
    username: dev_user
    password: dev_password

• application-prod.yml：

server:
  port: 80
spring:
  datasource:
    url: jdbc:mysql://prod-db.example.com:3306/prod_db
    username: prod_user
    password: prod_password

切换环境

• 通过命令行参数切换：

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

• 通过设置环境变量切换：

export SPRING_PROFILES_ACTIVE=prod
java -jar myapp.jar

五、注意事项

1. 敏感信息管理：对于敏感信息（如数据库密码），可以使用环境变量或配置中心（如 Spring Cloud Config）来管理。
2. 配置文件格式：确保配置文件的格式正确，尤其是 .yml 文件，注意缩进和空格的使用。
3. 环境变量优先级：环境变量的优先级高于配置文件中的设置，因此在使用环境变量时要小心，避免覆盖掉重要的配置。