为Converter添加Bean Validation时出现HV000151错误该如何解决

问题根源 #

这个报错是Jakarta Bean Validation（原JSR-380校验规范）的强制规则触发导致的：

子类重写父类/接口的方法时，不能修改父级方法定义的入参约束配置，否则违反里氏替换原则——父级方法的调用方本来不需要满足额外的参数约束，子类却新增了约束，会导致父类实例可以正常运行的场景，替换成子类实例就会报错。

你当前实现的Converter接口的convert方法本身没有定义任何参数校验注解，你在实现类的重写方法入参上加了@NotNull约束，同时类上标注了@Validated让Spring做方法校验代理，就触发了Hibernate Validator的规则检查，抛出HV000151错误。

可行解决方案（适配你无法修改Converter接口的要求） #

方案1：将参数校验挪到方法内部实现（最稳妥，无副作用） #

直接去掉入参上的@NotNull注解，在方法内部手动做非空判断，不需要依赖注解式校验：

public class StringToFooConverter implements Converter<String, Foo> {
   @Override
   public Foo convert(final String source) {
      // 手动做非空校验
      if (source == null) {
          throw new IllegalArgumentException("待转换的源字符串不能为null");
      }
      return new Foo(source);
   }
}

如果需要兼容Spring的校验异常体系，也可以手动注入Validator实例触发校验，不会触发方法级的继承约束检查。

方案2：全局放开重写方法参数约束限制（快速但有全局风险） #

如果你一定要用注解式参数校验，可以在Spring Boot配置文件中添加如下配置，关闭全局的重写方法入参约束检查：

# Spring Boot 2.4+版本支持该配置
spring.validation.allow-overriding-method-parameter-constraints=true

注意该配置是全局生效的，会放宽所有方法校验的继承约束检查，可能带来隐式的契约不一致风险，需要自行评估使用。

方案3：自定义校验切面处理Converter校验 #

单独给所有Converter实现类写一个自定义AOP切面，在切面中做参数校验，不走Spring默认的@Validated方法校验逻辑，完全规避规则检查。

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