Spring自动装配Bean时分组验证失效，如何通过注解实现条件验证？

问题背景 #

我正在实现一个Spring自动配置，需要基于以下场景做条件化的配置属性验证：

• 无配置属性且不存在MyService Bean时，自动配置不执行任何操作；
• 不存在MyService Bean但配置了username和password时，创建MyService Bean并验证这两个属性非空；
• 存在MyService Bean时，创建OncePerRequestFilter并验证appName属性非空。

尝试用验证分组实现：在自动配置类的@Bean方法上添加@Validated指定分组，配置属性类MyProperties的字段用@NotBlank绑定对应分组，但验证未自动生效；给MyProperties加@Validated注解后，分组验证仍不生效。想知道是否仅靠Jakarta和Spring Boot注解就能实现，还是必须手动调用Validator？

解决方案 #

可以仅依靠Jakarta Validation和Spring Boot注解实现，无需手动调用Validator，但要注意正确的用法逻辑：

前提准备 #

确保项目中引入Spring Boot的validation starter依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

1. 定义验证分组 #

创建两个标记接口作为分组标识：

// 用于MyService场景的验证分组
public interface MyServiceValidationGroup {}

// 用于Filter场景的验证分组
public interface FilterValidationGroup {}

2. 配置属性类绑定分组 #

在MyProperties中给对应字段绑定分组：

@ConfigurationProperties(prefix = "my")
public class MyProperties {

    @NotBlank(groups = MyServiceValidationGroup.class)
    private String username;

    @NotBlank(groups = MyServiceValidationGroup.class)
    private String password;

    @NotBlank(groups = FilterValidationGroup.class)
    private String appName;

    // getter、setter省略
}

3. 自动配置类的条件化实现 #

在自动配置类中，结合Spring Boot条件注解和分组验证实现场景逻辑：

场景2：创建MyService并验证username/password

@Configuration
@EnableConfigurationProperties(MyProperties.class)
public class MyAutoConfiguration {

    // 无MyService Bean且配置了username、password时生效
    @Bean
    @ConditionalOnMissingBean(MyService.class)
    @ConditionalOnProperty(prefix = "my", value = {"username", "password"}, matchIfMissing = false)
    public MyService myService(@Validated(MyServiceValidationGroup.class) MyProperties properties) {
        return new MyService(properties.getUsername(), properties.getPassword());
    }
}

这里通过@Validated(MyServiceValidationGroup.class)修饰方法参数，Spring会自动触发对应分组的校验，校验不通过会在启动阶段抛出异常。

场景3：创建Filter并验证appName

@Bean
@ConditionalOnBean(MyService.class)
public OncePerRequestFilter myFilter(@Validated(FilterValidationGroup.class) MyProperties properties) {
    return new OncePerRequestFilter() {
        @Override
        protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException {
            // 使用properties.getAppName()做逻辑处理
            filterChain.doFilter(request, response);
        }
    };
}

同样通过参数上的@Validated指定分组，Spring会自动校验appName字段。

场景1：无属性且无MyService Bean时不动作

无需额外配置，Spring的条件注解会自动过滤掉上述两个Bean的创建逻辑，自动配置不执行任何操作。

为什么之前的分组验证不生效？ #

• 单独在@Bean方法上添加@Validated不会触发参数的分组校验，必须在方法参数上添加@Validated指定分组；
• 若仅给MyProperties类加@Validated，需要确保该类是Spring管理的Bean（比如通过@Component或@EnableConfigurationProperties导入），且校验触发时机正确（比如在Bean创建时注入参数）。

内容的提问来源于stack exchange，提问作者Aisteru Firë