为何环境变量无法覆盖Spring Boot配置？

开发者阿泽

2026-7-27

问题原因及解决方案

1. SPRING_APPLICATION_JSON优先级覆盖环境变量

Spring Boot的配置加载优先级中，SPRING_APPLICATION_JSON的优先级高于操作系统环境变量。你在SPRING_APPLICATION_JSON里明确设置了clientId和clientSecret为空字符串，这会直接覆盖环境变量中的对应值，导致环境变量配置不生效。

解决：

移除SPRING_APPLICATION_JSON中authorization-configs数组的空值配置，或直接删除该部分内容；
若需保留SPRING_APPLICATION_JSON其他配置，确保authorization-configs段不包含空值的clientId和clientSecret，让环境变量能正常覆盖默认值。

2. 配置类绑定逻辑存在缺陷

问题点：

TokenGrantConfiguration不是data class，且构造参数未用val/var声明，这些参数无法成为类的公开属性，Spring无法完成属性绑定；
AbcConfiguration中authorizationConfigs使用private var，结合@ConstructorBinding后，构造函数参数为私有，Spring无法通过反射完成构造函数注入；
嵌套类TokenGrantConfiguration未添加@ConstructorBinding，不符合构造函数绑定的嵌套类要求。

修正后的配置类：

@ConstructorBinding
@ConfigurationProperties("abc-config")
data class AbcConfiguration(
    val authorizationConfigs: List<TokenGrantConfiguration> = listOf(),
)

@ConstructorBinding
data class TokenGrantConfiguration(
    val clientId: String,
    val clientSecret: String,
)

说明：

将AbcConfiguration的authorizationConfigs改为val，确保构造参数公开（data class默认参数公开），适配@ConstructorBinding的注入规则；
TokenGrantConfiguration改为data class并添加@ConstructorBinding，用val声明构造参数，让Spring能通过构造函数完成嵌套对象的属性绑定。