Java 后端 / 系统课时

管理多环境配置

管理多环境配置

开发、测试和生产环境通常共享配置结构,却使用不同的地址、超时和日志级别。本课将用 Profile 拆分环境差异,再用环境变量与命令行参数覆盖敏感或临时值,最终形成可预测、可验证的配置加载规则。

学习目标

  • 使用 application-{profile}.yml 管理环境差异
  • 掌握常用配置来源从低到高的覆盖顺序
  • 通过启动参数和环境变量验证最终生效值

先划分公共项与环境差异

公共配置放入 application.yml,只有真正随环境变化的值才进入 Profile 文件。这样既能避免复制整份配置,也能让代码始终读取同一组键名。

Spring Boot 多环境配置覆盖链

常用生产配置来源可按“低优先级到高优先级”理解为:包内公共文件、包内 Profile 文件、包外公共文件、包外 Profile 文件、操作系统环境变量、Java 系统属性、命令行参数。测试注解和开发工具还可能加入更高优先级来源,但不应作为生产部署的常规手段。

创建可观察配置结果的应用

下面的入口程序直接读取 Spring Environment,用于打印激活的 Profile 和最终属性值。它不依赖前一课的配置类,可以在任意基础 Spring Boot 3 项目中独立验证。

java
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 提供本地可用的默认值。

yaml
spring:
  application:
    name: profile-demo

app:
  endpoint: http://localhost:9000
  timeout: 3s

开发环境文件 src/main/resources/application-dev.yml 只覆盖开发差异。

yaml
app:
  endpoint: http://localhost:9001
  timeout: 5s

logging:
  level:
    com.example.profiledemo: DEBUG

生产环境文件 src/main/resources/application-prod.yml 从环境变量读取服务地址,避免把真实地址或密钥固化在仓库中。

yaml
app:
  endpoint: ${APP_ENDPOINT}
  timeout: 2s

logging:
  level:
    root: WARN

Profile 文件会覆盖公共文件中的同名键。没有覆盖的键继续继承公共配置;若生产环境缺少必需的 APP_ENDPOINT,占位符无法解析,应用应直接启动失败。

激活开发环境

使用 Maven 插件激活 dev Profile。

bash
mvn spring-boot:run -Dspring-boot.run.profiles=dev

预期输出

text
profiles=dev
endpoint=http://localhost:9001
timeout=5s

这说明 application-dev.yml 已覆盖公共文件中的 endpoint 和 timeout。实际控制台还会包含启动日志,时间和进程信息可能不同。

用环境变量和命令行参数覆盖

下面同时设置生产 Profile、环境变量和命令行参数。环境变量先提供地址,命令行参数再覆盖同一个键,因此最终应以命令行值为准。

bash
APP_ENDPOINT=https://env.example.com mvn spring-boot:run -Dspring-boot.run.arguments="--spring.profiles.active=prod --app.endpoint=https://cli.example.com"

预期输出

text
profiles=prod
endpoint=https://cli.example.com
timeout=2s

部署时应把稳定的环境差异放在 Profile 或外部配置文件中,把密钥和平台注入值放在环境变量或密钥管理系统中,把命令行参数保留给临时覆盖。不要在 application-prod.yml 内设置 spring.profiles.active,激活哪个环境应由基础配置或启动方式决定。

处理多个 Profile

多个 Profile 可以按逗号顺序激活,例如 prod,observability。当两个 Profile 修改同一个属性时,后声明的 Profile 覆盖先声明的值,因此顺序必须写入部署规范,不能依赖团队成员的口头约定。

bash
mvn spring-boot:run -Dspring-boot.run.profiles=prod,observability

预期结果

text
profiles=prod,observability

若两个环境组合经常一起出现,可使用 Profile Group 统一命名;若只是一次性调试,优先使用明确的启动参数,避免继续增加难以维护的配置文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理多环境配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通