Spring Boot配置属性验证Bean无法被所有BeanPostProcessor处理的解决方法

问题场景 #

在Spring Boot 3.1.3 + Java 17环境中，通过主类上的@EnableConfigurationProperties({AppProperties.class})将配置记录类与application.yml绑定：

@Validated
@ConfigurationProperties("converter")
public record AppProperties(/* properties */) {

    public record TableConfig(/* properties */) {
        //
    }
}

同时自定义了配置属性验证器，并通过@Component指定了特定Bean名称：

@Component(EnableConfigurationProperties.VALIDATOR_BEAN_NAME)
public class AppPropertiesValidator implements Validator {
    // 验证逻辑代码省略
}

启动应用时出现如下警告：

2023-09-07T06:54:55.191+03:00 INFO 328 --- [ main] trationDelegate$BeanPostProcessorChecker : Bean 'configurationPropertiesValidator' of type [x.x.x.config.AppPropertiesValidator] is not eligible for getting processed by all BeanPostProcessors (for example: not eligible for auto-proxying)

尝试为AppProperties或AppPropertiesValidator添加@Lazy注解未解决问题。

解决方法 #

方法1：使用@ConfigurationPropertiesBinding注解注册验证器 #

移除验证器类上的@Component(EnableConfigurationProperties.VALIDATOR_BEAN_NAME)，替换为@ConfigurationPropertiesBinding注解，Spring会自动识别该验证器并关联到对应配置属性类，避免初始化顺序冲突：

@ConfigurationPropertiesBinding
public class AppPropertiesValidator implements Validator {

    @Override
    public boolean supports(Class<?> clazz) {
        return AppProperties.class.isAssignableFrom(clazz);
    }

    @Override
    public void validate(Object target, Errors errors) {
        // 自定义验证逻辑实现
    }
}

方法2：通过配置类手动注册验证器Bean #

删除验证器类上的@Component注解，在自定义配置类中手动注册该验证器Bean，指定目标Bean名称：

@Configuration
public class AppConfig {

    @Bean(EnableConfigurationProperties.VALIDATOR_BEAN_NAME)
    public Validator appPropertiesValidator() {
        return new AppPropertiesValidator();
    }
}

这种方式可以更精准控制Bean的初始化时机，避免过早加载导致的BeanPostProcessor处理限制。

方法3：改用JSR-380注解实现验证（无需自定义Validator） #

如果验证逻辑不复杂，直接在配置记录类的字段上使用JSR-380标准验证注解（如@NotNull、@Min、@Valid等），Spring Boot会自动启用默认验证机制，无需编写自定义验证器：

@Validated
@ConfigurationProperties("converter")
public record AppProperties(
    @NotNull(message = "API密钥不能为空")
    String apiKey,
    @Valid
    TableConfig tableConfig
) {

    public record TableConfig(
        @Min(value = 1, message = "最大行数不能小于1")
        int maxRows
    ) {
        //
    }
}

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