Springboot如何实现自定义错误页面（错误处理机制详解）

最新推荐文章于 2024-09-14 15:48:02 发布
最新推荐文章于 2024-09-14 15:48:02 发布
阅读量4.7k 收藏 24
点赞数 7
分类专栏： # SpringBoot 文章标签： java
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_43888891/article/details/112254711
版权

一般我们在做项目的时候，错误机制是必备的常识，基本每个项目都会做错误处理，不可能项目一报错直接跳到原始报错页面，本篇博客主要针对springboot默认的处理机制，以及自定义错误页面处理进行讲解，需要的朋友们下面随着小编来一起学习学习吧！

目录

这里我们通过代码示例，来解析他的原因及原理，只有懂了原理才可以更好的让我们在实战过程使用起来游刃有余！

在博客下半部分是本人的一个小demo，方便大家快速掌握！

如果对原理感觉很枯燥的，可以直接跳过，看代码，看完之后感兴趣了可以再回来看哈哈

默认效果示例

springboot他是有自己默认的处理机制的。在你刚创建一个springboot项目去访问一个没有的路径会发现他是会弹出来这样的信息。

而我们用postman直接接口访问，会发现他返回的不再是页面。默认响应一个json数据

这时候该有人在想，springboot他是如何识别我们是否是页面访问的呢？

效果示例原因

springboot默认错误处理机制他是根据Headers当中的Accept来判断的，这个参数无论是postman访问还是页面访问都会传入。

页面访问的时候他传入的是test/html

而postman是这个

错误机制原理

原因我们大概了解了，接下来通过翻看源码我们简单的来理解一下他的原理。

简单回顾springboot原理

springboot之所以开箱即用，是因为很多框架他已经帮我们配置好了，他内部有很多AutoConfiguration，其中ErrorMvcAutoConfiguration类就是错误机制配置。

存放于这个jar包下
在这里插入图片描述

springboo 2.4版本当中ErrorMvcAutoConfiguration存放于这个路径

springboot 1.5版本ErrorMvcAutoConfiguration存放于这个路径

当然他只是版本之间类存放位置发生一些改动，但是源码区别不是很大。

springboot内部使用到配置的地方，都是去容器当中取的，容器的作用就是将这些配置实例化过程放到了启动，我们在用的时候直接从容器当中取而无需创建，这也就是围绕容器开发的原因，在使用springboot的时候应该也都会发现，我们想要修改springboot的一些默认配置都会想方设法把他放到容器当中，他才会生效。

在源码当中会发现存在大量@ConditionalOnMissingBean，这个就是假如我们项目当中配置了该项配置，springboot就不会使用他的默认配置了，就直接用我们配置好的。

ErrorMvcAutoConfiguration配置

ErrorMvcAutoConfiguration给容器中添加了以下组件：

1、DefaultErrorAttributes

页面当中错误信息，以及访问时间等等，都是在DefaultErrorAttributes当中的这两个方法当中获取的。

	@Override
	public Map<String, Object> getErrorAttributes(WebRequest webRequest, ErrorAttributeOptions options) {
		Map<String, Object> errorAttributes = getErrorAttributes(webRequest, options.isIncluded(Include.STACK_TRACE));
		if (Boolean.TRUE.equals(this.includeException)) {
			options = options.including(Include.EXCEPTION);
		}
		if (!options.isIncluded(Include.EXCEPTION)) {
			errorAttributes.remove("exception");
		}
		if (!options.isIncluded(Include.STACK_TRACE)) {
			errorAttributes.remove("trace");
		}
		if (!options.isIncluded(Include.MESSAGE) && errorAttributes.get("message") != null) {
			errorAttributes.put("message", "");
		}
		if (!options.isIncluded(Include.BINDING_ERRORS)) {
			errorAttributes.remove("errors");
		}
		return errorAttributes;
	}

	@Override
	@Deprecated
	public Map<String, Object> getErrorAttributes(WebRequest webRequest, boolean includeStackTrace) {
		Map<String, Object> errorAttributes = new LinkedHashMap<>();
		errorAttributes.put("timestamp", new Date());
		addStatus(errorAttributes, webRequest);
		addErrorDetails(errorAttributes, webRequest, includeStackTrace);
		addPath(errorAttributes, webRequest);
		return errorAttributes;
	}
2、BasicErrorController

处理默认/error请求

也正是BasicErrorController这两个方法，来判断是返回错误页面还是返回json数据

@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, getErrorAttributeOptions(request, MediaType.TEXT_HTML)));
		response.setStatus(status.value());
		ModelAndView modelAndView = resolveErrorView(request, response, status, model);
		return (modelAndView != null) ? modelAndView : new ModelAndView("error", model);
	}

	@RequestMapping
	public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) {
		HttpStatus status = getStatus(request);
		if (status == HttpStatus.NO_CONTENT) {
			return new ResponseEntity<>(status);
		}
		Map<String, Object> body = getErrorAttributes(request, getErrorAttributeOptions(request, MediaType.ALL));
		return new ResponseEntity<>(body, status);
	}
3、ErrorPageCustomizer

系统出现错误以后来到error请求进行处理；（就相当于是web.xml注册的错误页 面规则）

4、DefaultErrorViewResolver

DefaultErrorViewResolverConfiguration内部类

在这里我们可以看出他将DefaultErrorViewResolver注入到了容器当中

DefaultErrorViewResolver这个对象当中有两个方法，来完成了根据状态跳转页面。

	@Override
	public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status,
			Map<String, Object> model) {
			
		//获取错误状态码，这里可以看出他将状态码传入了resolve方法
		ModelAndView modelAndView = resolve(String.valueOf(status), 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) {
		//从这里可以得知，当我们报404错误的时候，他会去error文件夹找404的页面，如果500就找500的页面。
		String errorViewName = "error/" + viewName;
		//模板引擎可以解析这个页面地址就用模板引擎解析
		TemplateAvailabilityProvider provider = this.templateAvailabilityProviders
				.getProvider(errorViewName, this.applicationContext);
		//模板引擎可用的情况下返回到errorViewName指定的视图地址
		if (provider != null) {
			return new ModelAndView(errorViewName, model);
		}
		//模板引擎不可用，就在静态资源文件夹下找errorViewName对应的页面 error/404.html
		return resolveResource(errorViewName, model);
	}

组件执行步骤

一但系统出现4xx或者5xx之类的错误；ErrorPageCustomizer就会生效（定制错误的响应规则）；就会来到/error 请求；就会被BasicErrorController处理；去哪个页面是由DefaultErrorViewResolver解析得到的；

代码示例

这里我选择直接上代码，方便大家更快的上手。

1、导入依赖

这里我引用了thymeleaf模板，springboot内部为我们配置好了页面跳转功能。

这是本人写的一篇关于thymeleaf的博客，没用过的或者不是很了解的可以学习一下！

thymeleaf学习: https://blog.csdn.net/weixin_43888891/article/details/111350061.

<dependencies>
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-thymeleaf</artifactId>
	</dependency>
	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-web</artifactId>
	</dependency>

	<dependency>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-tomcat</artifactId>
		<scope>provided</scope>
	</dependency>
</dependencies>

2、自定义异常

作用：面对一些因为没找到数据而报空指针的错误，我们可以采取手动抛异常。

package com.gzl.cn;

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;

@ResponseStatus(HttpStatus.NOT_FOUND)
public class NotFoundException extends RuntimeException {

    public NotFoundException() {
    }

    public NotFoundException(String message) {
        super(message);
    }

    public NotFoundException(String message, Throwable cause) {
        super(message, cause);
    }
}

3、定义异常拦截

package com.gzl.cn.handler;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.core.annotation.AnnotationUtils;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

@ControllerAdvice
public class ControllerExceptionHandler {

    private final Logger logger = LoggerFactory.getLogger(this.getClass());


    @ExceptionHandler(Exception.class)
    public ModelAndView exceptionHander(HttpServletRequest request, Exception e) throws Exception {
        logger.error("Requst URL : {}，Exception : {}", request.getRequestURL(),e);
		
		//假如是自定义的异常，就让他进入404，其他的一概都进入error页面
        if (AnnotationUtils.findAnnotation(e.getClass(), ResponseStatus.class) != null) {
            throw e;
        }

        ModelAndView mv = new ModelAndView();
        mv.addObject("url",request.getRequestURL());
        mv.addObject("exception", e);
        mv.setViewName("error/error");
        return mv;
    }
}

4、创建测试接口

package com.gzl.cn.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

import com.gzl.cn.NotFoundException;

@Controller
public class HelloController {

    //这个请求我们抛出我们定义的错误，然后被拦截到直接跳到404，这个一般当有一些数据查不到的时候手动抛出
    @GetMapping("/test")
    public String test(Model model){
        String a = null;
        if(a == null) {
        	throw new NotFoundException();
        }
        System.out.println(a.toString());
        return "success";
    }
    
    //这个请求由于a为null直接进500页面
    @GetMapping("/test2")
    public String test2(Model model){
        String a = null;
        System.out.println(a.toString());
        return "success";
    }
}

5、创建404页面

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
	<h2>404</h2>
    <p>对不起，你访问的资源不存在</p>
</body>
</html>

6、创建error页面

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
	<h2>错误</h2>
    <p>对不起，服务异常，请联系管理员</p>
    
	<!--这段代码在页面不会展现，只会出现在控制台，假如线上报错可以看控制台快速锁定错误原因-->    
	<div>
	    <div th:utext="'&lt;!--'" th:remove="tag"></div>
	    <div th:utext="'Failed Request URL : ' + ${url}" th:remove="tag"></div>
	    <div th:utext="'Exception message : ' + ${exception.message}" th:remove="tag"></div>
	    <ul th:remove="tag">
	      <li th:each="st : ${exception.stackTrace}" th:remove="tag"><span th:utext="${st}" th:remove="tag"></span></li>
	    </ul>
	    <div th:utext="'--&gt;'" th:remove="tag"></div>
	</div>
</body>
</html>

7、项目结构

8、运行效果

http://localhost:8080/test2

这时候可以观察到，那段代码在此处生效了，这样做的好处就是客户看不到，看到了反而也不美观，所以采取这种方式。

访问一个不存在的页面

访问http://localhost:8080/test
这个时候会发现他跳到了404页面

记得给小编点赞哦！

Spring Boot自定义错误页面
12-06
该资源是我的博文《Spring Boot自定义错误页面》的关联资源，博文链接：http://blog.csdn.net/github_32521685/article/details/50198467
springboot自定义错误页面
热门推荐
我要上天
05-19 1万+
自定义一个controller实现ErrorController，重写getErrorPath方法，ErrorController是springboot自带的错误控制器@Controller @RequestMapping(value = "/error")//这个映射是必须的 public class BaseErrorController implements ErrorController {
十二，Spring Boot 异常处理(自定义异常页面，全局异常，自定义异常)
最新发布
weixin_61635597的博客
09-14 1715
默认情况下，Spring Boot 提供/ error处理所有的错误的映射，也就是说当出现错误时，Spring Boot 底层会请求转发到 /error 这个映射。注意是：请求转发，不是重定向的。Spring Boot 它是有自己的默认的处理机制的，在你创建的一个 Spring Boot 项目去访问一个没有的路径会发现，Spring Boot 它是会弹出来这样的信息。这是 Spring Boot 给我们内置好的，编写好的，默认配置好的 错误信息页面。
SpringBoot自定义错误页
qq_25775675的博客
11-08 2098
Spring Boot 中的错误默认是由= null)?}其中, errorHtml方法用来返回错误HTML页面, error用来返回错误JSON,具体返回的是HTML还是JSON，则要看请求头的Accept参数。返回JSON的逻辑很简单，不必过多介绍，返回HTML的逻辑稍微有些复杂，在 errorHtml方法中，通过调用resolveErrorView方法来获取一个错误视图的ModelAndView。
SpringBoot-自定义错误页
m0_58815972的博客
08-15 1158
SpringBoot自定义错误页
SpringBoot自定义错误页面
白不懂黑的静的专栏
10-23 553
使用Web应用时,在请求处理过程中发生错误是非常常见的情况.SpringBoot为我们提供一个默认的映射:/error,当处理中抛出异常之后,会转到该请求中处理,并且该请求有一个全局的错误页面来展示异常内容.比如现在启动my-spring-boot项目,项目启动完成之后,在浏览器中随便输入一个访问地址,由于地址不存在,SpringBoot会跳转到错误页面,如图所示. 虽然Spring Boot为我们提供了默认的错误页面映射,但是在实际应用中,上图所示的错误页面对用户来说并不友好,我们需要自己来实现异常
SpringBoot错误处理机制以及自定义异常处理详解
08-26
在默认的错误处理机制中，SpringBoot还提供了一些配置项，用于自定义错误处理行为。 自定义异常处理是指在SpringBoot应用程序中自定义异常处理逻辑。SpringBoot提供了多种方式来自定义异常处理，例如使用@Bean注解...
详解Springboot自定义异常处理
08-30
总结起来，自定义Spring Boot的异常处理主要包括两部分：一是通过`EmbeddedServletContainerCustomizer`定制错误页面的URL，二是通过实现`ErrorController`并重写其方法来控制错误的响应内容。这样，我们可以创建...
Springboot异常错误处理解决方案详解
09-07
1. **自定义错误页面** 当Spring Boot应用遇到异常时，它会根据模板引擎的情况寻找相应的错误页面。如果应用使用了模板引擎（如Thymeleaf或Freemarker），Spring Boot会在`templates/error`目录下查找与错误状态码...
Springboot错误处理机制详解及示例解析
Springboot错误处理机制实现解析详解 在Spring Boot应用中，错误处理是确保用户体验的关键部分。Spring Boot提供了默认的错误处理机制，使得开发者能够更方便地管理应用程序中的异常情况，并以一致且用户友好的方式...
SpringBoot自定义错误页面，SpringBoot 404、500错误提示页面
04-27
NULL 博文链接：https://fanshuyao.iteye.com/blog/2414828
springboot 自定义错误页面
weixin_30642561的博客
10-24 321
Spring Boot默认使用嵌入式Tomcat，默认没有页面来处理404等常见错误。因此，为了给用户最佳的使用体验，404等常见错误需要我们自定义页面来处理。 在springboot2.0之前用org.springframework.boot.context.embedded.EmbeddedServletContainerCustomizer类来实现该功能。 使用Java 7内部类的实现：...
Spring Boot定制错误页面
NewBeen1的博客
11-06 366
本文将通过实例代码和原理解析，详细介绍如何在Spring Boot应用中定制错误页面，提升用户体验和故障排除效率。
Spring Boot 自定义错误页
探索er的博客
04-01 2916
自定义错误页
评论 15
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

怪 咖@

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值