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

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异常错误处理解决方案详解