非Spring Boot环境下Spring BeanPostProcessor中@Value占位符无法解析问题

问题背景 #

你在传统Tomcat（非Spring Boot）应用中搭配Spring Boot BOM 2.4.0开发时，遇到了一个特殊的SpEL解析失效问题：

• 当配置类仅实现ApplicationContextAware，或实现BeanPostProcessor但仅重写postProcessAfterInitialization时，@Value("${spring.kafka.maximumRequestSize:15728640}")能正常解析占位符并注入数值；
• 但一旦重写postProcessBeforeInitialization（哪怕只是直接返回原bean），就会抛出NumberFormatException，提示无法将字符串${spring.kafka.maximumRequestSize:15728640}转换成整数；
• 甚至极简示例中，仅实现BeanPostProcessor并使用@Value注入就会触发该问题，而同样代码在Spring Boot环境下完全正常运行。

核心原因 #

这个问题的本质是非Spring Boot环境中，自定义BeanPostProcessor的初始化时机早于属性占位符解析处理器：

• 在Spring Boot中，框架会自动配置并调整BeanPostProcessor的加载顺序，确保PropertySourcesPlaceholderConfigurer这类属性解析器先于自定义BeanPostProcessor生效；
• 但在传统Spring应用中，Spring会优先加载所有BeanPostProcessor类型的Bean，此时PropertySourcesPlaceholderConfigurer还未完成占位符解析工作，导致自定义BeanPostProcessor中的@Value字段直接注入了原始占位符字符串，进而引发类型转换错误。

从错误堆栈也能验证这一点：自定义的KafkaTracingDecorator（作为BeanPostProcessor）在初始化时，AutowiredAnnotationBeanPostProcessor处理它的@Value字段，但此时占位符还未被替换，最终抛出NumberFormatException。

解决方案 #

针对非Spring Boot环境，你可以通过以下几种方式解决该问题：

1. 显式注册静态的PropertySourcesPlaceholderConfigurer #

在配置类中用静态方法定义PropertySourcesPlaceholderConfigurer Bean，静态Bean会在容器初始化阶段更早被创建，确保占位符解析逻辑在自定义BeanPostProcessor实例化前生效：

@Configuration
public class PropertyResolverConfig {
    @Bean
    public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
        return new PropertySourcesPlaceholderConfigurer();
    }
}

2. 调整自定义BeanPostProcessor的加载优先级 #

通过@Order注解给自定义BeanPostProcessor指定更低的优先级（数值越大优先级越低），让属性解析相关的处理器先执行：

@Configuration
@Order(Ordered.LOWEST_PRECEDENCE)
public class KafkaTracingDecorator implements BeanPostProcessor, ApplicationContextAware {
    // 你的业务代码实现
}

不过这种方式的可靠性略低于第一种，因为Spring对BeanPostProcessor的加载顺序有特殊处理逻辑，显式定义静态解析器是更稳妥的方案。

3. 绕过@Value，手动从ApplicationContext获取属性 #

直接通过ApplicationContext的环境变量获取属性值，避开@Value的时机限制：

@Configuration
public class KafkaTracingDecorator implements BeanPostProcessor, ApplicationContextAware {
    private int maxRequestSize;
    private KafkaTracing kafkaTracing;

    @Override
    public void setApplicationContext(final ApplicationContext applicationContext) throws BeansException {
        kafkaTracing = applicationContext.getBean(KafkaTracing.class);
        // 手动解析属性，指定默认值
        String maxSizeStr = applicationContext.getEnvironment()
                .getProperty("spring.kafka.maximumRequestSize", "15728640");
        maxRequestSize = Integer.parseInt(maxSizeStr);
    }

    @Override
    public Object postProcessBeforeInitialization(final Object bean, final String beanName) throws BeansException {
        if (bean instanceof KafkaProducer) {
            return kafkaTracing.producer((KafkaProducer) bean);
        } else if (bean instanceof KafkaConsumer) {
            return kafkaTracing.consumer((KafkaConsumer) bean);
        } else {
            return bean;
        }
    }
}

额外说明 #

该问题已在Spring Framework的官方Issue中被跟踪确认，属于非Spring Boot环境下的特殊场景问题，并非代码逻辑错误。Spring Boot环境中框架自动处理了BeanPostProcessor与属性解析器的顺序，因此不会出现该问题。

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