Spring中@Value注解注入final字段失效问题咨询

问题原因 #

1. final字段的赋值规则限制：Java规定final修饰的字段必须在对象实例化阶段完成赋值（可通过构造方法、静态初始化块或直接赋值），而Spring的字段注入逻辑是在对象实例化完成后才执行的，此时final字段已经无法被修改。
2. Spring注入逻辑的误判：当Spring尝试给final字段执行字段注入却发现无法修改时，会错误地将@Value指定的配置项当作需要从容器中查找的Bean类型（此处为long），但Spring容器中不存在long类型的Bean，因此抛出NoSuchBeanDefinitionException。

解决办法 #

1. 构造方法注入（推荐方案） #

将@Value标注在构造方法的参数上，利用构造方法在实例化阶段执行的特性，既满足final字段的赋值要求，又符合Spring官方推荐的依赖注入规范：

@Component // 确保当前类被Spring容器管理
public class CacheConfig {
    private final long expireInMinutes;

    // 通过构造方法注入配置值，完成final字段赋值
    public CacheConfig(@Value("${a.b.cache.expireInMinutes:15}") long expireInMinutes) {
        this.expireInMinutes = expireInMinutes;
    }
}

2. 方法注入（你测试有效的方案） #

可以通过@Value标注在方法参数上，让Spring在对象初始化时调用该方法完成配置注入：

• 若允许移除final修饰符，可使用Setter方法注入：

@Component
public class CacheConfig {
    private long expireInMinutes;

    @Value("${a.b.cache.expireInMinutes:15}")
    public void setExpireInMinutes(long expireInMinutes) {
        this.expireInMinutes = expireInMinutes;
    }
}

• 若要保留final字段，更推荐直接使用构造方法注入，这是最符合Java语法规范和Spring设计理念的方式。

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