Java 后端 / 系统课时
管理多环境配置
管理多环境配置
开发、测试和生产环境通常共享配置结构,却使用不同的地址、超时和日志级别。本课将用 Profile 拆分环境差异,再用环境变量与命令行参数覆盖敏感或临时值,最终形成可预测、可验证的配置加载规则。
学习目标
- 使用
application-{profile}.yml管理环境差异 - 掌握常用配置来源从低到高的覆盖顺序
- 通过启动参数和环境变量验证最终生效值
先划分公共项与环境差异
公共配置放入 application.yml,只有真正随环境变化的值才进入 Profile 文件。这样既能避免复制整份配置,也能让代码始终读取同一组键名。

常用生产配置来源可按“低优先级到高优先级”理解为:包内公共文件、包内 Profile 文件、包外公共文件、包外 Profile 文件、操作系统环境变量、Java 系统属性、命令行参数。测试注解和开发工具还可能加入更高优先级来源,但不应作为生产部署的常规手段。
创建可观察配置结果的应用
下面的入口程序直接读取 Spring Environment,用于打印激活的 Profile 和最终属性值。它不依赖前一课的配置类,可以在任意基础 Spring Boot 3 项目中独立验证。
package com.example.profiledemo;
import java.util.Arrays;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.core.env.Environment;
@SpringBootApplication
public class ProfileDemoApplication {
public static void main(String[] args) {
SpringApplication.run(ProfileDemoApplication.class, args);
}
@Bean
CommandLineRunner report(Environment environment) {
return args -> {
String[] active = environment.getActiveProfiles();
String profiles = active.length == 0
? "default"
: String.join(",", Arrays.asList(active));
System.out.printf(
"profiles=%s%nendpoint=%s%ntimeout=%s%n",
profiles,
environment.getProperty("app.endpoint"),
environment.getProperty("app.timeout")
);
};
}
}这里读取的是合并后的最终结果,而不是某个文件的原始值,因此非常适合排查“明明改了配置却没有生效”的问题。
编写公共与 Profile 配置
公共文件 src/main/resources/application.yml 提供本地可用的默认值。
spring:
application:
name: profile-demo
app:
endpoint: http://localhost:9000
timeout: 3s开发环境文件 src/main/resources/application-dev.yml 只覆盖开发差异。
app:
endpoint: http://localhost:9001
timeout: 5s
logging:
level:
com.example.profiledemo: DEBUG生产环境文件 src/main/resources/application-prod.yml 从环境变量读取服务地址,避免把真实地址或密钥固化在仓库中。
app:
endpoint: ${APP_ENDPOINT}
timeout: 2s
logging:
level:
root: WARNProfile 文件会覆盖公共文件中的同名键。没有覆盖的键继续继承公共配置;若生产环境缺少必需的 APP_ENDPOINT,占位符无法解析,应用应直接启动失败。
激活开发环境
使用 Maven 插件激活 dev Profile。
mvn spring-boot:run -Dspring-boot.run.profiles=dev预期输出
profiles=dev
endpoint=http://localhost:9001
timeout=5s这说明 application-dev.yml 已覆盖公共文件中的 endpoint 和 timeout。实际控制台还会包含启动日志,时间和进程信息可能不同。
用环境变量和命令行参数覆盖
下面同时设置生产 Profile、环境变量和命令行参数。环境变量先提供地址,命令行参数再覆盖同一个键,因此最终应以命令行值为准。
APP_ENDPOINT=https://env.example.com mvn spring-boot:run -Dspring-boot.run.arguments="--spring.profiles.active=prod --app.endpoint=https://cli.example.com"预期输出
profiles=prod
endpoint=https://cli.example.com
timeout=2s部署时应把稳定的环境差异放在 Profile 或外部配置文件中,把密钥和平台注入值放在环境变量或密钥管理系统中,把命令行参数保留给临时覆盖。不要在 application-prod.yml 内设置 spring.profiles.active,激活哪个环境应由基础配置或启动方式决定。
处理多个 Profile
多个 Profile 可以按逗号顺序激活,例如 prod,observability。当两个 Profile 修改同一个属性时,后声明的 Profile 覆盖先声明的值,因此顺序必须写入部署规范,不能依赖团队成员的口头约定。
mvn spring-boot:run -Dspring-boot.run.profiles=prod,observability预期结果
profiles=prod,observability若两个环境组合经常一起出现,可使用 Profile Group 统一命名;若只是一次性调试,优先使用明确的启动参数,避免继续增加难以维护的配置文件。