对于最新的稳定版本,请使用 Spring Framework 6.2.0spring-doc.cadn.net.cn

异常

如果在请求映射期间发生异常,或者从请求处理程序(例如 一个@Controller)、DispatcherServletdelegates 到HandlerExceptionResolverbean 来解决异常并提供替代处理,这通常是 error 响应。spring-doc.cadn.net.cn

下表列出了可用的HandlerExceptionResolver实现:spring-doc.cadn.net.cn

表 1.HandlerExceptionResolver 实现
HandlerExceptionResolver 描述

SimpleMappingExceptionResolverspring-doc.cadn.net.cn

异常类名称和错误视图名称之间的映射。用于渲染 浏览器应用程序中的错误页面。spring-doc.cadn.net.cn

DefaultHandlerExceptionResolverspring-doc.cadn.net.cn

解决 Spring MVC 引发的异常并将它们映射到 HTTP 状态代码。 参见 alternativeResponseEntityExceptionHandlerError Responses (错误响应)。spring-doc.cadn.net.cn

ResponseStatusExceptionResolverspring-doc.cadn.net.cn

使用@ResponseStatus注解并将它们映射到 HTTP 状态 代码。spring-doc.cadn.net.cn

ExceptionHandlerExceptionResolverspring-doc.cadn.net.cn

通过调用@ExceptionHandler方法中的@Controller@ControllerAdvice类。请参阅 @ExceptionHandler方法spring-doc.cadn.net.cn

解析器链

您可以通过声明多个HandlerExceptionResolverbean 并设置其order属性。 order 属性越高,异常解析程序的位置就越晚。spring-doc.cadn.net.cn

的合同HandlerExceptionResolver指定它可以返回:spring-doc.cadn.net.cn

MVC Config 自动为默认 Spring MVC 声明内置解析器 exceptions, 对于@ResponseStatus注解的异常,以及为了支持@ExceptionHandler方法。您可以自定义或替换该列表。spring-doc.cadn.net.cn

容器错误页面

如果任何HandlerExceptionResolver因此, left 进行传播,或者如果响应状态设置为错误状态(即 4xx、5xx), Servlet 容器可以在 HTML 中呈现默认错误页。自定义默认 error page 中,可以在web.xml. 以下示例显示了如何执行此作:spring-doc.cadn.net.cn

<error-page>
	<location>/error</location>
</error-page>

在前面的示例中,当异常冒泡或响应具有错误状态时, Servlet 容器在容器内向配置的 URL 发出 ERROR 调度 (例如,/error).然后由DispatcherServlet,可能映射它 更改为@Controller,该 URL 可以实现以返回带有 model 的错误视图名称 或呈现 JSON 响应,如下例所示:spring-doc.cadn.net.cn

@RestController
public class ErrorController {

	@RequestMapping(path = "/error")
	public Map<String, Object> handle(HttpServletRequest request) {
		Map<String, Object> map = new HashMap<>();
		map.put("status", request.getAttribute("jakarta.servlet.error.status_code"));
		map.put("reason", request.getAttribute("jakarta.servlet.error.message"));
		return map;
	}
}
@RestController
class ErrorController {

	@RequestMapping(path = ["/error"])
	fun handle(request: HttpServletRequest): Map<String, Any> {
		val map = HashMap<String, Any>()
		map["status"] = request.getAttribute("jakarta.servlet.error.status_code")
		map["reason"] = request.getAttribute("jakarta.servlet.error.message")
		return map
	}
}
Servlet API 不提供在 Java 中创建错误页面映射的方法。您可以 但是,请同时使用WebApplicationInitializer和最小的web.xml.