BindingResult 方法参数的存在决定了抛出异常吗？

我有一个春天@RestController其 POST 端点定义如下：

@RestController
@Validated
@RequestMapping("/example")
public class Controller {

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public ResponseEntity<?> create(@Valid @RequestBody Request request,
                                    BindingResult _unused, // DO NOT DELETE
                                    UriComponentsBuilder uriBuilder) {
        // ...
    }
}

它还有一个异常处理程序javax.validation.ConstraintViolationException:

@ExceptionHandler({ConstraintViolationException.class})
@ResponseStatus(HttpStatus.BAD_REQUEST)
ProblemDetails handleValidationError(ConstraintViolationException e) {...}

我们的 Spring-Boot 应用程序正在使用spring-boot-starter-validation用于验证。这Request对象用途javax.validation.*注释将约束应用于各个字段，如下所示：

public class Request {

    private Long id;

    @Size(max = 64, message = "name length cannot exceed 64 characters")
    private String name;

    // ...
}

如上所述，如果您使用无效请求 POST 请求，验证将抛出 ConstraintViolationException，该异常将由异常处理程序处理。这有效，我们对其进行了单元测试，一切都很好。

我注意到BindingResult在 post 方法中没有使用（名称_unused并评论//DO NOT DELETE有点危险信号。）我继续删除了参数。突然间，我的测试失败了——入站请求仍然经过验证，但它不再抛出 ConstraintValidationException ...现在它抛出MethodArgumentNotValidException！不幸的是，我无法使用这个其他异常，因为它不包含我需要的格式的失败验证（也不包含我需要的所有数据）。

为什么BindingResult参数列表中的存在控制抛出哪个异常？如何删除未使用的变量并仍然抛出ConstraintViolationExceptionjavax.validation何时判断请求体无效？

Spring-Boot 2.5.5

• spring-boot-启动器-web
• spring-boot-starter-验证

OpenJDK 17。

这里涉及两层验证，按以下顺序发生：

1. 控制器层 :

   • 当控制器方法的参数注释为时启用@RequestBody or @ModelAttribute与@Valid or @Validated或任何名称以“Valid”开头的注释（请参阅this https://github.com/spring-projects/spring-framework/blob/e4e667acdb774b45164f3ec345bfdf9e406e537f/spring-context/src/main/java/org/springframework/validation/annotation/ValidationAnnotationUtils.java#L45对于逻辑）。
   • 基于DataBinder https://docs.spring.io/spring-framework/docs/current/reference/html/web.html#mvc-ann-initbinder stuff
   • 只能验证请求
   • 如果出现验证错误并且没有BindingResult控制器方法中的参数，抛出org.springframework.web.bind.MethodArgumentNotValidException。否则，继续调用控制器方法BindingResult捕获验证错误信息的参数。

2. Bean的方法层 :

   • 如果 spring bean 带有注释，则启用它@Validated并且方法参数或返回值仅使用 bean 验证注释进行注释，例如@Valid , @Size etc.
   • 基于AOP的东西。方法拦截器是MethodValidationInterceptor
   • 可以验证请求和响应
   • 如果验证错误，抛出javax.validation.ConstraintViolationException.

最后两层中的验证将委托给 bean 验证来执行实际验证。

因为控制器实际上是一个 spring bean ，所以在调用控制器方法时，两层中的验证都会生效，您的案例完全证明了这一点，并发生以下情况：

1. DataBinder验证请求不正确，但由于控制器方法有BindingResult参数，它跳过抛出MethodArgumentNotValidException并继续调用控制器方法

2. MethodValidationInterceptor验证请求不正确，并抛出ConstraintViolationException

文件并没有明确提及此类行为。以上是我阅读源码后总结的。我同意这很令人困惑，尤其是在您的情况下，当在两个层中都启用验证并且还与BindingResult争论。您可以看到 bean 验证实际上验证了请求两次，这听起来很尴尬......

因此，要解决您的问题，您可以禁用控制器层的验证DataBinder并且始终依赖于 bean 方法级别验证。

要对所有控制器全局禁用它，您可以创建一个@ControllerAdvice与以下@InitBinder method:

@ControllerAdvice
public class InitBinderControllerAdvice {

    @InitBinder
    private void initBinder(WebDataBinder binder) {
        binder.setValidator(null);
    }
} 

要仅对一个控制器禁用它，您可以添加此@InitBinder该控制器的方法：

@RestController
@Validated
@RequestMapping("/example")
public class Controller {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        binder.setValidator(null);
   }

}

然后甚至删除BindingResult从控制器方法中，它也应该抛出ConstraintViolationException.