同一份代码,开发连本机库、测试连测试库、线上连生产库——配置必须跟着环境走。Boot 的配置体系就是为「一份代码多套配置」设计的:优先级规则 + profile 分文件 + 类型安全绑定,三板斧讲清楚。
Boot 的配置不止 application.yml 一个地方,常见来源从高到低:
命令行参数 (--server.port=8081)
> SPRING_APPLICATION_JSON 环境变量
> 操作系统环境变量 (SERVER_PORT)
> application-{profile}.yml(特定环境)
> application.yml(默认)
记法一句话:离人越近优先级越高——命令行是运维手动敲的,最该赢;默认文件是开发写的兜底,最该让。这套规则解掉了老 Spring 时代「改个端口重新打包」的苦:同一镜像,线上用 -Dspring.profiles.active=prod 或环境变量切换,镜像本身一个字节不动。
环境变量还有一层松散绑定(属性名的横杠、下划线、驼峰互通的匹配规则):spring.datasource.driver-class-name 对应环境变量 SPRING_DATASOURCE_DRIVERCLASSNAME。容器时代配置全靠环境变量注入,这条转换规则要熟。
拿一个实战场景把优先级跑通。K8s 里部署同一个镜像:开发环境的 Deployment 注入环境变量 SERVER_PORT=8081,测试环境命令行参数 --server.port=8082,生产不动配置走默认。三层来源各管一段——镜像是同一个是事实,配置是每个环境自己的决定。再排一个常见的糊涂账:application.yml 写了 server.port: 8080,命令行给了 --server.port=9090,最终生效 9090;很多人直觉「文件里写死了应该文件赢」,恰好记反——文件是兜底不是圣旨,外部覆盖是特性不是 bug。
优先级还有两个细节值得咬准。其一,同优先级内后加载者覆盖先加载者:jar 包外的 application.yml 覆盖包内的(外置配置文件优先),这给了「不改包改行为」的运维后门。其二,spring.config.import 引入的文件按就近原则参与排序——本地文件与 Nacos 远程配置同时存在时,默认远程优先于本地 profile 文件、低于命令行,混用时要实测一次确认,别背口诀了事。
三个文件管三个环境:
# application.yml —— 公共配置
spring:
profiles:
active: dev # 默认激活 dev
# application-dev.yml —— 本机:连localhost、开debug日志
# application-test.yml —— 测试:连测试库
# application-prod.yml —— 生产:连生产库、日志只留warn
激活方式四选一:配置文件里 spring.profiles.active、命令行 --spring.profiles.active=prod、环境变量、启动类 SpringApplication.setAdditionalProfiles()。生产强烈建议命令行或环境变量——配置文件里的默认值只该指向 dev,避免「带 prod 配置的包被误启动」。
分组功能顺带一提:spring.profiles.group.prod[0]=db-prod 让 prod 激活时连带激活 db-prod——数据库、中间件配置按维度拆组,比一个大 prod 文件清爽。
profile 不只分文件,还能分代码:@Profile("dev") 标在 @Bean 或 @Configuration 上,这个 Bean 只在该环境激活时注册。典型用法是「环境专属的假实现」——dev 环境注入一个 MockPaymentService 直接返回成功,prod 环境注册真实现调银行通道,同一个接口两种装配,切换零侵入。这其实是 14.1 条件装配的特化版:@Profile 等价于按环境生效的条件注解,思路一脉相承。
一个容易翻车的细节:profile 文件里不允许再写 spring.profiles.active——Boot 明确禁止 profile 专属文件互相激活,写了直接启动报错。原因想想就通:如果 dev 文件能激活 test、test 又能激活 prod,激活链会成环失控;所以「谁激活谁」只能写在公共文件或外部参数里,保持单向。
配置多了,@Value 一个个挖容易错。@ConfigurationProperties(按前缀把一组配置绑定成对象的注解)配一个记录类:
@Component
@ConfigurationProperties(prefix = "app.order")
public class OrderProperties {
private Integer timeoutMinutes = 30; // app.order.timeout-minutes
private Boolean enabled = true; // 未配置用默认值
private List<String> whiteList; // 集合也能绑
// 省略 getter/setter
}
对比 @Value 的三连优势:整组绑定不漏项、未配置走默认值不炸、IDE 有字段提示可跳转。配套细节两个:加 @Validated + @NotNull 可在启动期校验配置(配错当场报错,好过运行期才炸);@ConfigurationPropertiesScan 一开,连 @Component 都不用标。
绑定的表达力比看上去强:嵌套对象、Map、Duration 都能接。app.security.expire-time: 30m 直接绑成 java.time.Duration(不用自己换算毫秒);app.channel.wx.appid / app.channel.ali.appid 自动落进 Map<String, Channel> channels——key 就是中间那段,新增支付渠道只改 yaml 不改代码。当一个配置项开始带结构,就是它从 @Value 毕业去 ConfigurationProperties 的时候。
给数据库密码这类敏感项再加一道保险:jasypt(配置加密组件)以 ENC(密文) 格式存加密值,启动时用密钥解密——Git 仓库里没有明文,泄露面从「整个仓库」缩到「持有密钥的人」。密钥本身走环境变量注入,别又写回配置文件,否则等于没加密。这套方案与配置中心二选一或叠加:小团队环境变量、多环境矩阵上 Nacos,加密思想都通用。
本地文件解决「多环境」,解决不了「运行中改」——改个阈值还要重启发布。于是配置进配置中心(集中管理配置、推送变更的组件,如 Nacos):spring.config.import=nacos:app-order.yaml,文件里的配置变远程,控制台改完秒级推送。本地配置体系是地基:优先级规则、profile、绑定注解在 Nacos 场景下原样适用,只是「文件」换成了「命名空间 + dataId」。16.2 会从 Nacos 侧再讲一遍。
配置体系三板斧——优先级定胜负、profile 分环境、类型绑定保安全;下半场把文件换成 Nacos,规则原样继承。