Springboot异常错误处理解决方案详解

时间:2021-09-06 07:02:49

1.在有模板引擎的情况下:

springboot会默认找 templates/error/错误状态码.html,所以我们要定制化错误页面就可以到templates/error下创建一个【对应错误状态码.html】html文件,当发生此状态码的错误springboot就会来到对应的页面。

同时如果我们想让400-499之间的错误都去同一个错误页面,那我们可以在templates/error下创建一个4xx.html。同理500-599的错误可以用5xx.html。

Springboot异常错误处理解决方案详解

注意:springboot会优先匹配具体的【错误状态码.html】,然后再匹配4xx,5xx的。例如:发生了404错误,springboot优先到templates/error下找404.html,如果没有404.html,再找有没有4xx.html,有的话就会使用4xx.html。

在错误页面我们能够获取到的信息:

  • timestamp:时间戳
  • status:状态码
  • error:错误提示
  • exception:异常对象 springboot2.1.6在页面获取异常对象要现在全局配置文件中加入:server.error.include-exception=true
  • message:异常消息
  • errors:JSR数据校验的错误

2.在没有模板引擎(模板引擎找不到这个错误页面)的情况下,springboot会到静态资源文件夹下的error包下找。

3.以上都没有找到错误页面,就默认用springboot默认的错误提示页面

错误异常处理——自定义响应json数据

上边的错误处理中,如果是浏览器访问可以响应我们自己定制的错误页面,但是如果是其他客户端访问,则只会响应固定的json数据,如下图所示:

Springboot异常错误处理解决方案详解

下边讲解三个异常处理返回自定义json数据的方式

首先编写一个自定义异常类

public class UserNotExitException extends RuntimeException {
  public UserNotExitException() {
    super("用户不存在");
  }
}

方式一:

在异常处理器类中,通过map封装我们自己的json数据,然后将map返回。

@ControllerAdvice
public class MyExceptionHandler {

  @ResponseBody
  @ExceptionHandler(UserNotExitException.class)
  public Map<String,Object> userNotExitExceptionHandler(Exception e){
    Map<String,Object> map = new HashMap<>();
    map.put("code","user.notexit");
    map.put("message",e.getMessage());
    return map;
  }
}

  @ControllerAdvice:表明这是一个全局异常处理类

  @ExceptionHandler(UserNotExitException.class):表明标注的此方法用于处理UserNotExitException异常。

  @ResponseBody:将返回结果封装为json

3.结果

  不管浏览器还是其他客户端发生该异常都统一得到下图的响应

      Springboot异常错误处理解决方案详解

方式二:转发到/error,进行自适应响应效果处理

@ControllerAdvice
public class MyExceptionHandler {
  @ExceptionHandler(UserNotExitException.class)
  public String userNotExitExceptionHandler(Exception e, HttpServletRequest request){
    Map<String,Object> map = new HashMap<>();
    request.setAttribute("javax.servlet.error.status_code",500);
    map.put("code","user.notexit");
    map.put("message","用户出错了");
    return "forward:/error";
  }
}

将响应转发到 /error,让springboot帮我们生成自适应效果。但是必须注意,一定要设置错误状态码(如代码中标黄色的那一句代码)。不设置的话springboot就不会进入定制错误页面的解析流程。设置了之后springboot就会到templates/error/错误状态码.html页面处理。

注意:此方式浏览器访问发生错误不再响应的是json数据了,而是对于的错误响应网页。

Springboot异常错误处理解决方案详解

其他客户端访问响应的是json数据,但是响应的json数据中没有我们map中put的数据。

Springboot异常错误处理解决方案详解

方式三:通过DefaultErrorAttribute

1.在异常处理器类中将响应的json数据封装到map中,然后再将map放到请求域中

@ControllerAdvice
public class MyExceptionHandler {
  @ExceptionHandler(UserNotExitException.class)
  public String userNotExitExceptionHandler(Exception e, HttpServletRequest request){
    Map<String,Object> map = new HashMap<>();
    request.setAttribute("javax.servlet.error.status_code",500);
    map.put("code","user.notexit");
    map.put("message","用户出错了");
    request.setAttribute("ext",map);
    return "forward:/error";
  }
}

2.编写错误属性类:新建一个类继承DefaultErrorAttribute类,并重写其中的getErrorAttributes方法

@Component
public class MyErrorAttributes extends DefaultErrorAttributes {
  @Override
  public Map<String, Object> getErrorAttributes(WebRequest webRequest, boolean includeStackTrace) {
    Map<String, Object> map = super.getErrorAttributes(webRequest, includeStackTrace);
    map.put("company","atguigu");
    Map<String, Object> ext = (Map<String, Object>) webRequest.getAttribute("ext", 0);
    map.put("ext",ext);
    return map;
  }
}

注意:

(1).必须将错误属性类添加到spring容器中。

(2).第7行标黄那段代码的作用是获取异常处理类中的map。其中最后的参数0,是从request域中取出数据“ext”。若要从session域中取数据,则将该参数设置为1.(0是从request域获取数据,1是从session域中获取数据)

(3).错误属性类中返回的map中的所有内容,页面都可以获取到。

总结:

  此方式最好,当浏览器访问发生错误时,会响应对应的错误响应页面,当其他客户端访问发生错误时也会响应我们定制的json数据。

浏览器响应:

Springboot异常错误处理解决方案详解

其他客户端响应:

Springboot异常错误处理解决方案详解

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:https://www.cnblogs.com/bear7/p/13501638.html