spring boot 异常设计原理

spring boot 异常模板

查看浏览器请求应答信息如下：

请求返回信息以页面形式返回 ： Content-Type: text/html;charset=UTF-8
根据返回页面类型查看spring boot源码，找到返回类型为 text/html 的源码，如下所示：

// 接收https请求，以text/html 数据格式返回
@RequestMapping(produces = MediaType.TEXT_HTML_VALUE) 
	public ModelAndView errorHtml(HttpServletRequest request, HttpServletResponse response) {
		// 异常状态值
		HttpStatus status = getStatus(request);
		Map<String, Object> model = Collections
				.unmodifiableMap(getErrorAttributes(request, isIncludeStackTrace(request, MediaType.TEXT_HTML)));
		response.setStatus(status.value());
		ModelAndView modelAndView = resolveErrorView(request, response, status, model);
		// 返回页面及数据
		return (modelAndView != null) ? modelAndView : new ModelAndView("error", model);
	}

接口ErrorViewResolver 实现类 DefaultErrorViewResolver设置页面名称、页面参数信息。

异常页面查找过程

通过在项目页面配置目录下查找error子目录中与返回异常状态码对应的页面，以ModelAndView 对象形式返回。

本地不存在与状态码匹配的页面，以默认名称 ：error.html 页面返回。

本地存在error.html 页面则返回本地文件，否则将返回spring boot 默认页面。

页面匹配查找源码如下：

public class DefaultErrorViewResolver implements ErrorViewResolver, Ordered {
	// 异常状态与对相应的页面名称
	private static final Map<Series, String> SERIES_VIEWS;

	static {
		Map<Series, String> views = new EnumMap<>(Series.class);
		/** HttpStatus类中枚举信息:
		 *	CLIENT_ERROR(4),
		 *	SERVER_ERROR(5);
		 */
		views.put(Series.CLIENT_ERROR, "4xx");
		views.put(Series.SERVER_ERROR, "5xx");
		SERIES_VIEWS = Collections.unmodifiableMap(views);
	}
	@Override
	public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) {
		ModelAndView modelAndView = resolve(String.valueOf(status.value()), model);
		if (modelAndView == null && SERIES_VIEWS.containsKey(status.series())) {
			modelAndView = resolve(SERIES_VIEWS.get(status.series()), model);
		}
		return modelAndView;
	}

	private ModelAndView resolve(String viewName, Map<String, Object> model) {
		String errorViewName = "error/" + viewName;
		// 查找 error/名称为异常状态值的文件
		TemplateAvailabilityProvider provider = this.templateAvailabilityProviders.getProvider(errorViewName,
				this.applicationContext);
		if (provider != null) {
			return new ModelAndView(errorViewName, model);
		}
		return resolveResource(errorViewName, model);
	}
	......
  }

debugger 调试结果如下图：
当请求异常时返回页面名称为http网络异常状态码

如果未找到http异常状态码对应的页面时，会统一返回error.html页面

通过debugger源码得知此页面名称为 : error.html, 于是在 本地项目模板指定目录下创建此文件，然后得到如下：