使用Spring Boot 3.2.2（JDK21）：@ConfigurationProperties是否支持SpEL属性绑定？

在Spring Boot 3.2.2版本中，@ConfigurationProperties注解不支持直接通过SpEL表达式实现属性绑定。Spring Boot的配置属性绑定机制默认仅解析外部配置源（如application.yml/application.properties）中的${}占位符，不会处理#{}格式的SpEL表达式。

替代解决方案 #

如果需要实现动态属性绑定的需求，可以通过以下几种方式实现：

1. 结合@Value注解使用SpEL

@Value原生支持SpEL表达式，可以与@ConfigurationProperties共存于同一个配置类中，满足动态值的获取需求：

@Configuration
@ConfigurationProperties(prefix = "app")
public class AppConfig {
    // 静态配置属性
    private String basePath;

    // 通过SpEL获取系统属性
    @Value("#{systemProperties['user.home']}")
    private String userHome;

    // 结合静态属性与SpEL生成动态值
    @Value("#{${app.base-path} + '/temp'}")
    private String tempPath;

    // getter/setter
}

2. 自定义转换器解析SpEL

如果希望让@ConfigurationProperties直接支持SpEL解析，可以自定义Converter来处理属性值中的SpEL表达式：

@Component
public class SpelPropertyConverter implements Converter<String, String> {
    private final SpelExpressionParser parser = new SpelExpressionParser();
    private final StandardEvaluationContext evaluationContext = new StandardEvaluationContext();

    @Override
    public String convert(String source) {
        if (source == null || !source.trim().startsWith("#{")) {
            return source;
        }
        // 提取SpEL表达式内容并解析
        String spelContent = source.substring(2, source.length() - 1);
        Expression expression = parser.parseExpression(spelContent);
        return expression.getValue(evaluationContext, String.class);
    }
}

之后在配置类中使用时，配置文件里的SpEL格式属性会被自动解析：

# application.yml
app:
  dynamic-storage-path: "#{systemProperties['user.dir']}/storage"

3. 利用配置源的SpEL解析能力

如果使用Spring Cloud Config等外部配置服务，可以在配置源层面预先解析SpEL表达式，再将解析后的静态值传递给应用的@ConfigurationProperties绑定。这种方式依赖外部配置系统的支持，不属于Spring Boot本身的特性。

注意事项 #

• 优先使用Spring Boot原生的${}占位符引用环境变量、系统属性或其他配置值，仅在需要复杂动态计算时考虑SpEL。
• 过度使用SpEL会降低配置的可读性和可维护性，建议谨慎使用。

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ