Spring Boot版本间@ConditionalOnExpression Bean引用时机差异咨询

问题背景 #

• 技术栈：Spring Boot 3.0.4 + Java 17
• 需求：当上下文内某个包含内部列表属性的JavaBean（如pullConfigProperties）的列表大小满足指定值时，才创建依赖它的其他Bean
• 问题现象：使用@ConditionalOnExpression实现该条件时，3.0.4版本触发EL表达式错误：

  EL1008E: Property or field 'pullConfigProperties' cannot be found on object of type 'org.springframework.beans.factory.config.BeanExpressionContext' - maybe not public or not valid?
  

• 调试结论：3.0.4中条件表达式在目标Bean加入上下文前评估；3.1.3中表达式在目标Bean创建完成后评估

核心变更解析 #

Spring Boot 3.1.x 对@ConditionalOnExpression的执行逻辑做了关键调整：

• 3.0.x 及更早版本：@ConditionalOnExpression的表达式评估发生在Bean定义解析阶段，此时目标Bean尚未实例化，表达式只能访问Bean定义元数据或上下文基础变量，无法直接引用Bean实例的属性。
• 3.1.x 及之后版本：框架优化了条件注解的执行顺序，将@ConditionalOnExpression的评估延迟到目标Bean实例化完成后，此时可以直接通过表达式引用Bean实例及其属性（例如pullConfigProperties.list.size() >= 3）。

变更原因 #

这次调整是为了提升条件注解的灵活性，让开发者能够基于已实例化Bean的实际状态来控制Bean创建逻辑，同时解决旧版本中无法直接引用Bean实例属性的痛点，对齐了@ConditionalOnBean等其他条件注解的执行逻辑一致性。

3.0.x 版本兼容方案 #

如果需要在3.0.4中实现相同需求，可采用以下替代方案：

• 自定义Condition实现：结合@ConditionalOnBean，编写自定义Condition类，在matches方法中手动获取目标Bean实例，判断其列表属性的大小。
• 调整Bean加载顺序：通过@DependsOn等注解确保目标Bean在条件Bean之前实例化，但这种方式依赖Spring的Bean加载顺序，可靠性较低，不推荐作为长期方案。

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