使用枚举简单封装一个优雅的SpringBoot全局异常处理！

 这篇文章鸽了很久，我在这篇文章 《用好 Java 中的枚举，真的没有那么简单!》 中就提到要分享。还是昨天一个读者提醒我之后，我才发现自己没有将这篇文章发到公众号。说到这里，我发现自己一个很大的问题，就是有时候在文章里面说要更新什么，结果后面就忘记了，很多时候不是自己没写，就因为各种事情混杂导致忘记发了。以后要尽量改正这个问题!

在上一篇文章《SpringBoot 处理异常的几种常见姿势》中我介绍了：

  1. 使用 @ControllerAdvice 和 @ExceptionHandler 处理全局异常
  2. @ExceptionHandler 处理 Controller 级别的异常
  3. ResponseStatusException

通过这篇文章，可以搞懂如何在 Spring Boot 中进行异常处理。但是，光是会用了还不行，我们还要思考如何把异常处理这部分的代码写的稍微优雅一点。下面我会以我在工作中学到的一点实际项目中异常处理的方式，来说说我觉得稍微优雅点的异常处理解决方案。

下面仅仅是我作为一个我个人的角度来看的，如果各位读者有更好的解决方案或者觉得本文提出的方案还有优化的余地的话，欢迎在评论区评论。

最终效果展示

下面先来展示一下完成后的效果，当我们定义的异常被系统捕捉后返回给客户端的信息是这样的：

 

效果展示

返回的信息包含了异常下面 5 部分内容：

  1. 唯一标示异常的 code
  2. HTTP 状态码
  3. 错误路径
  4. 发生错误的时间戳
  5. 错误的具体信息

这样返回异常信息，更利于我们前端根据异常信息做出相应的表现。

异常处理核心代码

ErrorCode.java (此枚举类中包含了异常的唯一标识、HTTP 状态码以及错误信息)

这个类的主要作用就是统一管理系统中可能出现的异常，比较清晰明了。但是，可能出现的问题是当系统过于复杂，出现的异常过多之后，这个类会比较庞大。有一种解决办法：将多种相似的异常统一为一个，比如将用户找不到异常和订单信息未找到的异常都统一为“未找到该资源”这一种异常，然后前端再对相应的情况做详细处理(我个人的一种处理方法，不敢保证是比较好的一种做法)。

 
 
 
 
    
  
  
  
  
  1. import org.springframework.http.HttpStatus; 
    2. 
  
  
  
  
  2.  
    3. 
  
  
  
  
  3.  
    4. 
  
  
  
  
  4. public enum ErrorCode { 
    5. 
  
  
  
  
  5.  
    6. 
  
  
  
  
  6.     RESOURCE_NOT_FOUND(1001, HttpStatus.NOT_FOUND, "未找到该资源"), 
    7. 
  
  
  
  
  7.     REQUEST_VALIDATION_FAILED(1002, HttpStatus.BAD_REQUEST, "请求数据格式验证失败"); 
    8. 
  
  
  
  
  8.     private final int code; 
    9. 
  
  
  
  
  9.  
    10. 
  
  
  
  
  10.     private final HttpStatus status; 
    11. 
  
  
  
  
  11.  
    12. 
  
  
  
  
  12.     private final String message; 
    13. 
  
  
  
  
  13.  
    14. 
  
  
  
  
  14.     ErrorCode(int code, HttpStatus status, String message) { 
    15. 
  
  
  
  
  15.         this.code = code; 
    16. 
  
  
  
  
  16.         this.status = status; 
    17. 
  
  
  
  
  17.         this.message = message; 
    18. 
  
  
  
  
  18.     } 
    19. 
  
  
  
  
  19.  
    20. 
  
  
  
  
  20.     public int getCode() { 
    21. 
  
  
  
  
  21.         return code; 
    22. 
  
  
  
  
  22.     } 
    23. 
  
  
  
  
  23.  
    24. 
  
  
  
  
  24.     public HttpStatus getStatus() { 
    25. 
  
  
  
  
  25.         return status; 
    26. 
  
  
  
  
  26.     } 
    27. 
  
  
  
  
  27.  
    28. 
  
  
  
  
  28.     public String getMessage() { 
    29. 
  
  
  
  
  29.         return message; 
    30. 
  
  
  
  
  30.     } 
    31. 
  
  
  
  
  31.  
    32. 
  
  
  
  
  32.     @Override 
    33. 
  
  
  
  
  33.     public String toString() { 
    34. 
  
  
  
  
  34.         return "ErrorCode{" + 
    35. 
  
  
  
  
  35.                 "code=" + code + 
    36. 
  
  
  
  
  36.                 ", status=" + status + 
    37. 
  
  
  
  
  37.                 ", message='" + message + '\'' + 
    38. 
  
  
  
  
  38.                 '}'; 
    39. 
  
  
  
  
  39.     } 
    40. 
  
  
  
  
  40. } 
    41.

ErrorReponse.java(返回给客户端具体的异常对象)

这个类作为异常信息返回给客户端，里面包括了当出现异常时我们想要返回给客户端的所有信息。

 
 
 
 
    
  
  
  
  
  1. import org.springframework.util.ObjectUtils; 
    2. 
  
  
  
  
  2.  
    3. 
  
  
  
  
  3. import java.time.Instant; 
    4. 
  
  
  
  
  4. import java.util.HashMap; 
    5. 
  
  
  
  
  5. import java.util.Map; 
    6. 
  
  
  
  
  6.  
    7. 
  
  
  
  
  7. public class ErrorReponse { 
    8. 
  
  
  
  
  8.     private int code; 
    9. 
  
  
  
  
  9.     private int status; 
    10. 
  
  
  
  
  10.     private String message; 
    11. 
  
  
  
  
  11.     private String path; 
    12. 
  
  
  
  
  12.     private Instant timestamp; 
    13. 
  
  
  
  
  13.     private HashMap data = new HashMap(); 
    14. 
  
  
  
  
  14.  
    15. 
  
  
  
  
  15.     public ErrorReponse() { 
    16. 
  
  
  
  
  16.     } 
    17. 
  
  
  
  
  17.  
    18. 
  
  
  
  
  18.     public ErrorReponse(BaseException ex, String path) { 
    19. 
  
  
  
  
  19.         this(ex.getError().getCode(), ex.getError().getStatus().value(), ex.getError().getMessage(), path, ex.getData()); 
    20. 
  
  
  
  
  20.     } 
    21. 
  
  
  
  
  21.  
    22. 
  
  
  
  
  22.     public ErrorReponse(int code, int status, String message, String path, Map data) { 
    23. 
  
  
  
  
  23.         this.code = code; 
    24. 
  
  
  
  
  24.         this.status = status; 
    25. 
  
  
  
  
  25.         this.message = message; 
    26. 
  
  
  
  
  26.         this.path = path; 
    27. 
  
  
  
  
  27.         this.timestamp = Instant.now(); 
    28. 
  
  
  
  
  28.         if (!ObjectUtils.isEmpty(data)) { 
    29. 
  
  
  
  
  29.             this.data.putAll(data); 
    30. 
  
  
  
  
  30.         } 
    31. 
  
  
  
  
  31.     } 
    32. 
  
  
  
  
  32.  
    33. 
  
  
  
  
  33. // 省略 getter/setter 方法 
    34. 
  
  
  
  
  34.  
    35. 
  
  
  
  
  35.     @Override 
    36. 
  
  
  
  
  36.     public String toString() { 
    37. 
  
  
  
  
  37.         return "ErrorReponse{" + 
    38. 
  
  
  
  
  38.                 "code=" + code + 
    39. 
  
  
  
  
  39.                 ", status=" + status + 
    40. 
  
  
  
  
  40.                 ", message='" + message + '\'' + 
    41. 
  
  
  
  
  41.                 ", path='" + path + '\'' + 
    42. 
  
  
  
  
  42.                 ", timestamp=" + timestamp + 
    43. 
  
  
  
  
  43.                 ", data=" + data + 
    44. 
  
  
  
  
  44.                 '}'; 
    45. 
  
  
  
  
  45.     } 
    46. 
  
  
  
  
  46. } 
    47.

BaseException.java(继承自 RuntimeException 的抽象类，可以看做系统中其他异常类的父类)

系统中的异常类都要继承自这个类。

 
 
 
 
    
  
  
  
  
  1. public abstract class BaseException extends RuntimeException { 
    2. 
  
  
  
  
  2.     private final ErrorCode error; 
    3. 
  
  
  
  
  3.     private final HashMap data = new HashMap<>(); 
    4. 
  
  
  
  
  4.  
    5. 
  
  
  
  
  5.     public BaseException(ErrorCode error, Map data) { 
    6. 
  
  
  
  
  6.         super(error.getMessage()); 
    7. 
  
  
  
  
  7.         this.error = error; 
    8. 
  
  
  
  
  8.         if (!ObjectUtils.isEmpty(data)) { 
    9. 
  
  
  
  
  9.             this.data.putAll(data); 
    10. 
  
  
  
  
  10.         } 
    11. 
  
  
  
  
  11.     } 
    12. 
  
  
  
  
  12.  
    13. 
  
  
  
  
  13.     protected BaseException(ErrorCode error, Map data, Throwable cause) { 
    14. 
  
  
  
  
  14.         super(error.getMessage(), cause); 
    15. 
  
  
  
  
  15.         this.error = error; 
    16. 
  
  
  
  
  16.         if (!ObjectUtils.isEmpty(data)) { 
    17. 
  
  
  
  
  17.             this.data.putAll(data); 
    18. 
  
  
  
  
  18.         } 
    19. 
  
  
  
  
  19.     } 
    20. 
  
  
  
  
  20.  
    21. 
  
  
  
  
  21.     public ErrorCode getError() { 
    22. 
  
  
  
  
  22.         return error; 
    23. 
  
  
  
  
  23.     } 
    24. 
  
  
  
  
  24.  
    25. 
  
  
  
  
  25.     public Map getData() { 
    26. 
  
  
  
  
  26.         return data; 
    27. 
  
  
  
  
  27.     } 
    28. 
  
  
  
  
  28.  
    29. 
  
  
  
  
  29. } 
    30.

ResourceNotFoundException.java (自定义异常)

可以看出通过继承 BaseException 类我们自定义异常会变的非常简单!

 
 
 
 
    
  
  
  
  
  1. import java.util.Map; 
    2. 
  
  
  
  
  2.  
    3. 
  
  
  
  
  3. public class ResourceNotFoundException extends BaseException { 
    4. 
  
  
  
  
  4.  
    5. 
  
  
  
  
  5.     public ResourceNotFoundException(Map data) { 
    6. 
  
  
  
  
  6.         super(ErrorCode.RESOURCE_NOT_FOUND, data); 
    7. 
  
  
  
  
  7.     } 
    8. 
  
  
  
  
  8. } 
    9.

GlobalExceptionHandler.java(全局异常捕获)

我们定义了两个异常捕获方法。

这里再说明一下，实际上这个类只需要 handleAppException() 这一个方法就够了，因为它是本系统所有异常的父类。只要是抛出了继承 BaseException 类的异常后都会在这里被处理。

 
 
 
 
    
  
  
  
  
  1. import com.twuc.webApp.web.ExceptionController; 
    2. 
  
  
  
  
  2. import org.springframework.http.HttpHeaders; 
    3. 
  
  
  
  
  3. import org.springframework.http.HttpStatus; 
    4. 
  
  
  
  
  4. import org.springframework.http.ResponseEntity; 
    5. 
  
  
  
  
  5. import org.springframework.web.bind.annotation.ControllerAdvice; 
    6. 
  
  
  
  
  6. import org.springframework.web.bind.annotation.ExceptionHandler; 
    7. 
  
  
  
  
  7. import org.springframework.web.bind.annotation.ResponseBody; 
    8. 
  
  
  
  
  8. import javax.servlet.http.HttpServletRequest; 
    9. 
  
  
  
  
  9.  
    10. 
  
  
  
  
  10. @ControllerAdvice(assignableTypes = {ExceptionController.class}) 
    11. 
  
  
  
  
  11. @ResponseBody 
    12. 
  
  
  
  
  12. public class GlobalExceptionHandler { 
    13. 
  
  
  
  
  13.  
    14. 
  
  
  
  
  14.     // 也可以将 BaseException 换为 RuntimeException 
    15. 
  
  
  
  
  15.     // 因为 RuntimeException 是 BaseException 的父类 
    16. 
  
  
  
  
  16.     @ExceptionHandler(BaseException.class) 
    17. 
  
  
  
  
  17.     public ResponseEntity handleAppException(BaseException ex, HttpServletRequest request) { 
    18. 
  
  
  
  
  18.         ErrorReponse representation = new ErrorReponse(ex, request.getRequestURI()); 
    19. 
  
  
  
  
  19.         return new ResponseEntity<>(representation, new HttpHeaders(), ex.getError().getStatus()); 
    20. 
  
  
  
  
  20.     } 
    21. 
  
  
  
  
  21.  
    22. 
  
  
  
  
  22.     @ExceptionHandler(value = ResourceNotFoundException.class) 
    23. 
  
  
  
  
  23.     public ResponseEntity handleResourceNotFoundException(ResourceNotFoundException ex, HttpServletRequest request) { 
    24. 
  
  
  
  
  24.         ErrorReponse errorReponse = new ErrorReponse(ex, request.getRequestURI()); 
    25. 
  
  
  
  
  25.         return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorReponse); 
    26. 
  
  
  
  
  26.     } 
    27. 
  
  
  
  
  27. } 
    28.

(重要)一点扩展：

哈哈!实际上我多加了一个算是多余的异常捕获方法handleResourceNotFoundException() 主要是为了考考大家当我们抛出了 ResourceNotFoundException异常会被下面哪一个方法捕获呢?

答案：

会被handleResourceNotFoundException()方法捕获。因为 @ExceptionHandler 捕获异常的过程中，会优先找到最匹配的。

下面通过源码简单分析一下：

ExceptionHandlerMethodResolver.java中getMappedMethod决定了具体被哪个方法处理。

 
 
 
 
    
  
  
  
  
  1. @Nullable 
    2. 
  
  
  
  
  2.     private Method getMappedMethod(Class exceptionType) { 
    3. 
  
  
  
  
  3.         List> matches = new ArrayList<>(); 
    4. 
  
  
  
  
  4.     //找到可以处理的所有异常信息。mappedMethods 中存放了异常和处理异常的方法的对应关系 
    5. 
  
  
  
  
  5.         for (Class mappedException : this.mappedMethods.keySet()) { 
    6. 
  
  
  
  
  6.             if (mappedException.isAssignableFrom(exceptionType)) { 
    7. 
  
  
  
  
  7.                 matches.add(mappedException); 
    8. 
  
  
  
  
  8.             } 
    9. 
  
  
  
  
  9.         } 
    10. 
  
  
  
  
  10.     // 不为空说明有方法处理异常 
    11. 
  
  
  
  
  11.         if (!matches.isEmpty()) { 
    12. 
  
  
  
  
  12.       // 按照匹配程度从小到大排序 
    13. 
  
  
  
  
  13.             matches.sort(new ExceptionDepthComparator(exceptionType)); 
    14. 
  
  
  
  
  14.       // 返回处理异常的方法 
    15. 
  
  
  
  
  15.             return this.mappedMethods.get(matches.get(0)); 
    16. 
  
  
  
  
  16.         } 
    17. 
  
  
  
  
  17.         else { 
    18. 
  
  
  
  
  18.             return null; 
    19. 
  
  
  
  
  19.         } 
    20. 
  
  
  
  
  20.     } 
    21.

从源代码看出：getMappedMethod()会首先找到可以匹配处理异常的所有方法信息，然后对其进行从小到大的排序，最后取最小的那一个匹配的方法(即匹配度最高的那个)。

写一个抛出异常的类测试

Person.java

 
 
 
 
    
  
  
  
  
  1. public class Person { 
    2. 
  
  
  
  
  2.     private Long id; 
    3. 
  
  
  
  
  3.     private String name; 
    4. 
  
  
  
  
  4.  
    5. 
  
  
  
  
  5.     // 省略 getter/setter 方法 
    6. 
  
  
  
  
  6. } 
    7.

ExceptionController.java(抛出一场的类)

 
 
 
 
    
  
  
  
  
  1. @RestController 
    2. 
  
  
  
  
  2. @RequestMapping("/api") 
    3. 
  
  
  
  
  3. public class ExceptionController { 
    4. 
  
  
  
  
  4.  
    5. 
  
  
  
  
  5.     @GetMapping("/resourceNotFound") 
    6. 
  
  
  
  
  6.     public void throwException() { 
    7. 
  
  
  
  
  7.         Person p=new Person(1L,"SnailClimb"); 
    8. 
  
  
  
  
  8.         throw new ResourceNotFoundException(ImmutableMap.of("person id:", p.getId())); 
    9. 
  
  
  
  
  9.     } 
    10. 
  
  
  
  
  10.  
    11. 
  
  
  
  
  11. } 
    12.

源码地址：https://github.com/Snailclimb/springboot-guide/tree/master/source-code/basis/springboot-handle-exception-improved

名称栏目：使用枚举简单封装一个优雅的SpringBoot全局异常处理！
URL网址：http://www.csdahua.cn/qtweb/news24/472524.html

网站建设、网络推广公司-快上网，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 快上网

成都快上网为您推荐相关内容

网站改版知识

同城分类信息

app制作　　 　成都防护栏　　 　网络营销推广　　 　小谭建站　　 　成都网站设计　　 　四川航空文化　　 　遂宁海缘科技　　 　攀枝花网站建设　　 　专业网站建设　　 　网站维护　　 　犀浦雨棚定制　　 　温江网站制作　　 　微信公众号开发　　 　网站域名　　 　新网创想　　 　成都ssl证书申请　　 　中国电信西部信息中心机房　　 　四川成都展柜定制厂家　　 　成都品牌网站设计　　 　抖音短视频