Spring REST接口列表元素自定义校验未执行问题排查

核心问题 #

你的自定义校验器MyValidator是针对**List<Exp>类型**设计的，但你把@MyConstraint注解标注在了Exp类上，两者完全不匹配。Spring的@Valid只会校验请求体本身的约束，而你的请求体是List<Exp>，不是单个Exp对象，因此类上的注解不会被触发。

修复步骤 #

1. 将@MyConstraint注解移到请求参数上
   修改接口方法的参数声明，直接在List<Exp>参数上添加@MyConstraint：

   @RequestMapping(value = "/foobar", method = RequestMethod.PUT)
   public ... foobar(
           @Valid @MyConstraint @RequestBody(required = true) List<Exp> listDto) {
       // 方法逻辑
   }
   

2. 开启Spring集合校验支持
   在你的控制器类上添加@Validated注解，Spring默认不会对集合类型的参数触发校验，需要通过@Validated配合才能启用：

   @RestController
   @Validated // 添加该注解
   public class YourController {
       // 接口方法
   }
   

3. 修正校验器逻辑（关键）
   你的isValid方法逻辑存在矛盾：当前代码中，当列表中存在多个不同的idArea时会返回true（表示校验通过），这与注解提示信息"differents in list"不符。应改为当所有元素的idArea一致时返回true，否则返回false：

   @Override
   public boolean isValid(List<Exp> values, ConstraintValidatorContext context) {
       // 空列表的校验规则可根据业务需求调整
       if (values == null || values.isEmpty()) {
           return true;
       }
       // 获取基准idArea
       Integer targetIdArea = values.get(0).getExpedientes().getIdArea();
       // 校验所有元素的idArea是否与基准一致
       return values.stream()
               .map(Exp::getExpedientes)
               .map(G::getIdArea)
               .allMatch(idArea -> targetIdArea.equals(idArea));
   }
   

4. 确保依赖正确（Spring Boot场景）
   若使用Spring Boot 2.3及以上版本，需手动引入校验依赖：

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

   // Gradle
   implementation 'org.springframework.boot:spring-boot-starter-validation'
   

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