@ConfigurationProperties绑定同名属性被@Value注入后无法动态更新问题

核心逻辑说明 #

• @ConfigurationProperties 标注在@Bean方法上时，仅对方法返回的Bean实例的成员属性（需提供Setter方法） 做动态绑定，不会修改Bean实例化阶段的构造方法入参值。
• Spring 动态配置刷新机制默认不会重新执行Bean的构造方法，仅会通过Setter覆写支持动态绑定的属性。

异常现象根因 #

1. 代码中rateAdjuster的one、two属性是通过@Bean方法的入参以@Value注入，仅在Bean实例化时赋值一次，没有提供对应的Setter方法给@ConfigurationProperties做刷新，所以配置变更无法生效。
2. three、four可正常更新是因为这两个属性在RateAdjuster类中定义了成员变量和Setter方法，能被@ConfigurationProperties识别并绑定刷新。
3. 给limitedRepository加@ConfigurationProperties后触发了全量配置重绑逻辑，所以所有属性都能更新，但不符合限定仅rateAdjuster动态更新的需求。

方案1：调整属性绑定逻辑（最推荐） #

将需要动态刷新的属性全部移到RateAdjuster类中作为成员变量，添加对应Setter方法，删除@Bean方法入参中的@Value注入，完全交由@ConfigurationProperties绑定：

调整RateAdjuster类 #

public class RateAdjuster {
    // 配置属性设置默认值，由@ConfigurationProperties自动注入
    private int one = 1;
    private int two = 2;
    private int three = 3;
    private int four = 4;
    private final Repository limitedRepository;

    // 构造方法仅注入固定的业务依赖
    public RateAdjuster(Repository limitedRepository) {
        this.limitedRepository = limitedRepository;
    }

    // 为所有配置属性添加Setter方法
    public void setOne(int one) {
        this.one = one;
    }
    public void setTwo(int two) {
        this.two = two;
    }
    public void setThree(int three) {
        this.three = three;
    }
    public void setFour(int four) {
        this.four = four;
    }

    // 原有调度、调整限流逻辑保持不变
}

调整Config配置类 #

@Configuration
public class Config {

    @Bean("limitedRepository")
    public Repository limitedRepository(
            @Qualifier("repository") Repository repository,
            @Value("${some.property-one:1}") int one,
            @Value("${some.property-two:2}") int two) {
        return new LimitedRepository(repository, one, two);
    }

    @Bean("rateAdjuster")
    @ConfigurationProperties(prefix = "some.property")
    public RateAdjuster rateAdjuster(
            @Qualifier("limitedRepository") Repository limitedRepository) {
        return new RateAdjuster(limitedRepository);
    }
}

该方案完全符合业务预期：limitedRepository的属性启动时一次性注入，后续配置变更不会刷新；仅rateAdjuster的属性会被动态更新，可在调度逻辑中主动修改limitedRepository的速率值。

方案2：添加@RefreshScope注解 #

如果不想调整RateAdjuster类的原有结构，可以给rateAdjuster的@Bean方法添加@RefreshScope注解，配置变更时会重新实例化Bean，重新注入所有构造参数值：

@Bean("rateAdjuster")
@RefreshScope
@ConfigurationProperties(prefix = "some.property")
public RateAdjuster rateAdjuster(
        @Qualifier("limitedRepository") Repository limitedRepository,
        @Value("${some.property-one:1}") int one,
        @Value("${some.property-two:2}") int two,
        @Value("${some.property-three:3}") int three,
        @Value("${some.property-four:4}") int four
        ) {
    return new RateAdjuster(limitedRepository, one, two, three, four);
}

注意：该方案每次配置变更都会重建rateAdjuster实例，实例中的临时状态会丢失，需要结合业务场景评估是否适用。

方案3：独立配置属性类 #

将some.property前缀的所有属性单独定义为配置属性类，统一管理动态配置：

@ConfigurationProperties(prefix = "some.property")
@RefreshScope
public class RateAdjustProperties {
    private int one = 1;
    private int two = 2;
    private int three = 3;
    private int four = 4;
    // 省略Setter和Getter
}

然后将该配置类注入到RateAdjuster中使用即可，规范度更高，适合配置属性较多的场景。

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