Spring RestController中自定义JSR349验证器失效问题

以下是针对问题的具体排查步骤和解决方案：

• 检查自定义注解的约束定义规范
  Spring Boot 3.x依赖Hibernate Validator 8.x（对应Bean Validation 3.0/JSR-380），而JSR349是Bean Validation 1.1版本。需确保@CipAut注解的元注解配置覆盖目标场景：

  @Target({ElementType.PARAMETER, ElementType.FIELD})
  @Retention(RetentionPolicy.RUNTIME)
  @Constraint(validatedBy = ValidatorCipAut.class)
  public @interface CipAut {
      String message() default "无效的CIP格式";
      Class<?>[] groups() default {};
      Class<? extends Payload>[] payload() default {};
  }
  

  重点确认@Target包含PARAMETER（对应@PathVariable）和FIELD（对应Bean字段），@Retention设为RUNTIME。

• 验证自定义验证器适配Bean Validation 3.0
  确保ValidatorCipAut正确实现ConstraintValidator接口，且逻辑无误：

  public class ValidatorCipAut implements ConstraintValidator<CipAut, String> {
      @Override
      public boolean isValid(String value, ConstraintValidatorContext context) {
          // 替换为你的实际验证逻辑，无效值返回false
          if (value == null || !value.matches("符合要求的CIP正则表达式")) {
              return false;
          }
          return true;
      }
  }
  

  注意类需为public且提供无参构造函数。

• 开启Spring方法参数验证
  针对@PathVariable的参数验证，必须在RestController类上添加@Validated注解（Spring提供的org.springframework.validation.annotation.Validated），否则Spring不会触发参数级别的验证：

  @RestController
  @Validated
  public class TestController {
      @GetMapping("/check/{cip}")
      public String checkCip(@PathVariable @CipAut String cip) {
          return "验证通过";
      }
  }
  

• 确保验证器被Spring容器扫描
  若自定义验证器所在库未被Spring自动扫描，可直接给ValidatorCipAut添加@Component注解，或在配置类中用@ComponentScan指定验证器所在包，让Spring管理该Bean。

• 排查依赖冲突
  通过mvn dependency:tree（Maven）或./gradlew dependencies（Gradle）查看依赖树，确认hibernate-validator版本为8.x（Spring Boot 3.0.x对应版本），避免旧版本依赖导致的兼容问题。

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