此版本仍在开发中，尚未被视为稳定版。如需最新稳定版本，请使用 Spring Framework 7.0.6！spring-doc.cadn.net.cn

验证

参见响应式栈中的等效内容spring-doc.cadn.net.cn

Spring MVC 内置了对 xref page 方法的验证支持，包括Java Bean 验证。 验证可以在以下两个级别之一进行应用：spring-doc.cadn.net.cn

  1. Java Bean 验证会单独应用于使用 @jakarta.validation.Valid 或 Spring 的 @Validated 注解的 @ModelAttribute、 @RequestBody 和 @RequestPart 方法参数，前提是它是一个命令对象而非容器（如 Map 或 Collection），其方法签名中紧随其后没有 Errors 或 BindingResult，并且不需要其他方法验证（见下文）。MethodArgumentNotValidException 是在单独验证方法参数时抛出的异常。spring-doc.cadn.net.cn

  2. 当在方法参数上直接声明 @Constraint、@Min 等 @NotBlank 注解，或在方法上为返回值声明此类注解时，将对方法应用 Java Bean Validation。此时，方法级验证会取代原本可能单独应用于方法参数的任何验证，因为方法验证同时涵盖了方法参数约束以及通过 @Valid 实现的嵌套约束。 HandlerMethodValidationException 是在对方法应用验证时抛出的异常。spring-doc.cadn.net.cn

应用程序应同时处理 MethodArgumentNotValidException 和 HandlerMethodValidationException，因为根据控制器方法签名的不同，可能会抛出其中任意一个异常。不过，这两个异常的设计非常相似，几乎可以用相同的代码进行处理。主要区别在于，前者针对单个对象，而后者针对方法参数列表。spring-doc.cadn.net.cn

@Valid 不是一个约束注解，而是用于对象内部的嵌套约束。因此，单独使用 @Valid 并不会触发方法验证。@NotNull 则是一个约束注解，将其添加到带有 @Valid 的参数上会触发方法验证。对于可空性（nullability）问题，你也可以使用 required 或 @RequestBody 注解中的 @ModelAttribute 标志。

方法验证可与 Errors 或 BindingResult 方法参数结合使用。然而，只有当所有验证错误都出现在紧随其后的带有 Errors 的方法参数上时，控制器方法才会被调用。如果任何其他方法参数上存在验证错误，则会抛出 HandlerMethodValidationException。spring-doc.cadn.net.cn

你可以通过WebMvc 配置全局配置一个../mvc-config/validation.html，也可以在xref page或ann-initbinder.html中通过@InitBinder方法进行局部配置。你还可以使用多个验证器。spring-doc.cadn.net.cn

如果控制器类上使用了 @Validated 注解，那么 方法级验证将通过 AOP 代理应用。 为了利用 Spring Framework 6.1 中新增的 Spring MVC 内置方法验证支持， 你需要从控制器类上移除 @Validated 注解。

错误响应部分进一步详细说明了如何处理 MethodArgumentNotValidException 和 HandlerMethodValidationException，以及如何通过 MessageSource 及与区域（locale）和语言相关的资源包（resource bundles）来自定义它们的渲染方式。spring-doc.cadn.net.cn

如需对方法验证错误进行更进一步的自定义处理，您可以扩展 ResponseEntityExceptionHandler，或在控制器（controller）或 @ExceptionHandler 中使用 @ControllerAdvice 方法，直接处理 HandlerMethodValidationException。 该异常包含一个 ParameterValidationResult 列表，其中按方法参数对验证错误进行了分组。您可以遍历这些结果，也可以提供一个访问者（visitor），通过针对控制器方法参数类型的回调方法进行处理：spring-doc.cadn.net.cn

HandlerMethodValidationException ex = ... ;

ex.visitResults(new HandlerMethodValidationException.Visitor() {

	@Override
	public void requestHeader(RequestHeader requestHeader, ParameterValidationResult result) {
		// ...
	}

	@Override
	public void requestParam(@Nullable RequestParam requestParam, ParameterValidationResult result) {
		// ...
	}

	@Override
	public void modelAttribute(@Nullable ModelAttribute modelAttribute, ParameterErrors errors) {

	// ...

	@Override
	public void other(ParameterValidationResult result) {
		// ...
	}
});
// HandlerMethodValidationException
val ex

ex.visitResults(object : HandlerMethodValidationException.Visitor {

	override fun requestHeader(requestHeader: RequestHeader, result: ParameterValidationResult) {
		// ...
	}

	override fun requestParam(requestParam: RequestParam?, result: ParameterValidationResult) {
		// ...
	}

	override fun modelAttribute(modelAttribute: ModelAttribute?, errors: ParameterErrors) {
		// ...
	}

	// ...

	override fun other(result: ParameterValidationResult) {
		// ...
	}
})