如何通过SpEL访问@ConstructorBinding创建的Spring配置类？

问题根源 #

你遇到的报错是因为@Scheduled的SpEL表达式执行上下文（BeanExpressionContext）中，直接写#{myProperties.reloadPeriod}会被解析为查找当前上下文的属性，而非Spring容器中的Bean实例。同时如果配置类未被正确注册为Spring Bean，也会导致无法访问。

解决步骤 #

1. 确保配置类被注册为Spring Bean #

使用@ConstructorBinding的@ConfigurationProperties类，不能直接用@Component（两者不兼容），必须通过以下两种方式显式注册：

方式一：用@EnableConfigurationProperties指定注册

在启动类或任意配置类上添加该注解，明确指定你的配置类：

@SpringBootApplication
@EnableConfigurationProperties(MyProperties.class)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

方式二：用@ConfigurationPropertiesScan自动扫描

如果配置类在Spring可扫描包范围内，用该注解自动识别所有@ConfigurationProperties类：

@SpringBootApplication
@ConfigurationPropertiesScan(basePackageClasses = MyProperties.class)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

2. 在SpEL中正确引用Bean实例 #

在@Scheduled的fixedDelayString中，使用@beanName语法引用Spring容器中的配置类Bean，再访问其字段：

@Service
public class MyScheduledService {

    @Scheduled(fixedDelayString = "#{@myProperties.reloadPeriod}")
    public void executeScheduledTask() {
        // 任务逻辑
    }
}

注：Spring默认将配置类的Bean名称设为类名首字母小写（如MyProperties对应myProperties），如需自定义名称，可通过@Bean手动注册，但推荐使用默认命名规则。

配置类示例（结构校验） #

你的配置类需保持final类型，结合Lombok的@Value生成必要的构造方法和getter：

@Value // Lombok注解，生成final类、全参构造、字段getter
@ConstructorBinding
@ConfigurationProperties("my-app.conf")
public class MyProperties {
    private final Duration reloadPeriod;
}

补充说明 #

• Spring会自动解析Duration类型的配置值，你可以在配置文件中用标准格式（如PT5S表示5秒）或简化写法（如5s）配置my-app.conf.reload-period。
• 若仍无法访问，可通过ApplicationContext验证MyProperties是否已被注册为Bean，或检查配置类的包路径是否在Spring扫描范围内。

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