Spring Boot构造函数中如何用前缀读取配置属性并设默认值

首先，你遇到的问题其实是因为@Value和@ConfigurationProperties的绑定逻辑不太一样，而且当你已经使用@ConfigurationProperties来批量绑定配置时，完全不需要依赖@Value来做构造函数注入——Spring Boot本身就支持用@ConfigurationProperties配合构造函数完成属性绑定，这也是更符合最佳实践的方式。

步骤1：确认配置项对应关系 #

先把你的application.properties和要注入的属性对应好：

# 假设你原配置里的height.customer.feet是age的笔误，如果不是，后续字段名对应feet即可
height.customer.age=10
# 针对嵌套的时区配置，后续会用注解映射
height.customer.eu.timezone=UTC

步骤2：重构你的Customer类 #

根据你的Java版本和Spring Boot版本，有两种规范的写法：

方式一：用Java Record（Spring Boot 2.6+推荐，Java 16+支持）

Record天生就是不可变类，完美适配配置属性场景：

@Configuration
@EnableConfigurationProperties
@ConfigurationProperties(prefix = "height.customer")
public record Customer(Integer age, @PropertyName("eu.timezone") String timezone) {
    // Record自动生成构造函数和访问方法，无需额外编写
}

这里的@PropertyName("eu.timezone")是用来映射嵌套配置的——因为你的前缀是height.customer，所以配置项height.customer.eu.timezone会被精准绑定到timezone参数上。

方式二：普通类+构造函数绑定（兼容旧版本）

如果你的项目用Java 16以下，或者更习惯普通类，可以这么写：

@Configuration
@EnableConfigurationProperties
@ConfigurationProperties(prefix = "height.customer")
@ConstructorBinding // 关键注解：启用构造函数绑定，Spring Boot 2.2+需要
public class Customer {
    private final Integer age;
    private final String timezone;

    // 构造函数注入，参数通过@PropertyName映射配置项
    public Customer(Integer age, @PropertyName("eu.timezone") String timezone) {
        this.age = age;
        this.timezone = timezone;
    }

    // 若其他组件需要访问属性，添加getter即可
    public Integer getAge() {
        return age;
    }

    public String getTimezone() {
        return timezone;
    }
}

为什么不用@Value？ #

@Value更适合单个零散属性的注入，而@ConfigurationProperties是为批量绑定配置设计的，支持嵌套属性、自动类型转换、配置校验等功能。用构造函数注入时，@ConfigurationProperties通过@ConstructorBinding可以直接把配置项绑定到构造函数参数上，比@Value更简洁，也更贴合Spring Boot的设计思路。

额外小提示 #

建议给项目添加spring-boot-configuration-processor依赖，这样IDE会给你配置项的自动提示，避免拼写错误：

<!-- Maven依赖示例 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

内容的提问来源于stack exchange，提问作者Neetha123