使用枚举简单封装一个优雅的 Spring Boot 全局异常处理！
发布时间：2025-11-05 12:49:18 来源：创站工坊 作者：IT科技
这篇文章鸽了很久，使用我在这篇文章 《用好 Java 中的枚举枚举，真的简单没有那么简单!》 中就提到要分享。还是封装昨天一个读者提醒我之后，我才发现自己没有将这篇文章发到公众号。个优说到这里，雅的异常我发现自己一个很大的全局问题，就是处理有时候在文章里面说要更新什么，结果后面就忘记了，使用很多时候不是枚举自己没写，就因为各种事情混杂导致忘记发了。简单以后要尽量改正这个问题!
在上一篇文章《SpringBoot 处理异常的封装几种常见姿势》中我介绍了：
使用 @ControllerAdvice 和 @ExceptionHandler 处理全局异常 @ExceptionHandler 处理 Controller 级别的异常 ResponseStatusException通过这篇文章，可以搞懂如何在 Spring Boot 中进行异常处理。个优但是雅的异常，光是全局会用了还不行，我们还要思考如何把异常处理这部分的代码写的稍微优雅一点。下面我会以我在工作中学到的一点实际项目中异常处理的方式，来说说我觉得稍微优雅点的服务器托管异常处理解决方案。
下面仅仅是我作为一个我个人的角度来看的，如果各位读者有更好的解决方案或者觉得本文提出的方案还有优化的余地的话，欢迎在评论区评论。
最终效果展示
下面先来展示一下完成后的效果，当我们定义的异常被系统捕捉后返回给客户端的信息是这样的：
效果展示
返回的信息包含了异常下面 5 部分内容：
唯一标示异常的 code HTTP 状态码 错误路径 发生错误的时间戳 错误的具体信息这样返回异常信息，更利于我们前端根据异常信息做出相应的表现。
异常处理核心代码
ErrorCode.java (此枚举类中包含了异常的唯一标识、HTTP 状态码以及错误信息)
这个类的主要作用就是统一管理系统中可能出现的异常，比较清晰明了。但是，b2b信息网可能出现的问题是当系统过于复杂，出现的异常过多之后，这个类会比较庞大。有一种解决办法：将多种相似的异常统一为一个，比如将用户找不到异常和订单信息未找到的异常都统一为“未找到该资源”这一种异常，然后前端再对相应的情况做详细处理(我个人的一种处理方法，不敢保证是比较好的一种做法)。
import org.springframework.http.HttpStatus; public enum ErrorCode { RESOURCE_NOT_FOUND(1001, HttpStatus.NOT_FOUND, "未找到该资源"), REQUEST_VALIDATION_FAILED(1002, HttpStatus.BAD_REQUEST, "请求数据格式验证失败"); private final int code; private final HttpStatus status; private final String message; ErrorCode(int code, HttpStatus status, String message) { this.code = code; this.status = status; this.message = message; } public int getCode() { return code; } public HttpStatus getStatus() { return status; } public String getMessage() { return message; } @Override public String toString() { return "ErrorCode{" + "code=" + code + ", status=" + status + ", message=" + message + + }; } }ErrorReponse.java(返回给客户端具体的异常对象)
这个类作为异常信息返回给客户端，里面包括了当出现异常时我们想要返回给客户端的所有信息。
import org.springframework.util.ObjectUtils; import java.time.Instant; import java.util.HashMap; import java.util.Map; public class ErrorReponse { private int code; private int status; private String message; private String path; private Instant timestamp; private HashMap<String, Object> data = new HashMap<String, Object>(); public ErrorReponse() { } public ErrorReponse(BaseException ex, String path) { this(ex.getError().getCode(), ex.getError().getStatus().value(), ex.getError().getMessage(), path, ex.getData()); } public ErrorReponse(int code, int status, String message, String path, Map<String, Object> data) { this.code = code; this.status = status; this.message = message; this.path = path; this.timestamp = Instant.now(); if (!ObjectUtils.isEmpty(data)) { this.data.putAll(data); } } // 省略 getter/setter 方法 @Override public String toString() { return "ErrorReponse{" + "code=" + code + ", status=" + status + ", message=" + message + + ", path=" + path + + ", timestamp=" + timestamp + ", data=" + data + }; } }BaseException.java(继承自 RuntimeException 的抽象类，可以看做系统中其他异常类的父类)
系统中的异常类都要继承自这个类。
public abstract class BaseException extends RuntimeException { private final ErrorCode error; private final HashMap<String, Object> data = new HashMap<>(); public BaseException(ErrorCode error, Map<String, Object> data) { super(error.getMessage()); this.error = error; if (!ObjectUtils.isEmpty(data)) { this.data.putAll(data); } } protected BaseException(ErrorCode error, Map<String, Object> data, Throwable cause) { super(error.getMessage(), cause); this.error = error; if (!ObjectUtils.isEmpty(data)) { this.data.putAll(data); } } public ErrorCode getError() { return error; } public Map<String, Object> getData() { return data; } }ResourceNotFoundException.java (自定义异常)
可以看出通过继承 BaseException 类我们自定义异常会变的非常简单!
import java.util.Map; public class ResourceNotFoundException extends BaseException { public ResourceNotFoundException(Map<String, Object> data) { super(ErrorCode.RESOURCE_NOT_FOUND, data); } }GlobalExceptionHandler.java(全局异常捕获)
我们定义了两个异常捕获方法。
这里再说明一下，实际上这个类只需要 handleAppException() 这一个方法就够了，因为它是本系统所有异常的父类。只要是WordPress模板抛出了继承 BaseException 类的异常后都会在这里被处理。
import com.twuc.webApp.web.ExceptionController; import org.springframework.http.HttpHeaders; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseBody; import javax.servlet.http.HttpServletRequest; @ControllerAdvice(assignableTypes = {ExceptionController.class}) @ResponseBody public class GlobalExceptionHandler { // 也可以将 BaseException 换为 RuntimeException // 因为 RuntimeException 是 BaseException 的父类 @ExceptionHandler(BaseException.class) public ResponseEntity<?> handleAppException(BaseException ex, HttpServletRequest request) { ErrorReponse representation = new ErrorReponse(ex, request.getRequestURI()); return new ResponseEntity<>(representation, new HttpHeaders(), ex.getError().getStatus()); } @ExceptionHandler(value = ResourceNotFoundException.class) public ResponseEntity<ErrorReponse> handleResourceNotFoundException(ResourceNotFoundException ex, HttpServletRequest request) { ErrorReponse errorReponse = new ErrorReponse(ex, request.getRequestURI()); return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorReponse); } }(重要)一点扩展：
哈哈!实际上我多加了一个算是多余的异常捕获方法handleResourceNotFoundException() 主要是为了考考大家当我们抛出了 ResourceNotFoundException异常会被下面哪一个方法捕获呢?
答案：
会被handleResourceNotFoundException()方法捕获。因为 @ExceptionHandler 捕获异常的过程中，会优先找到最匹配的。
下面通过源码简单分析一下：
ExceptionHandlerMethodResolver.java中getMappedMethod决定了具体被哪个方法处理。
@Nullable private Method getMappedMethod(Class<? extends Throwable> exceptionType) { List<Class<? extends Throwable>> matches = new ArrayList<>(); //找到可以处理的所有异常信息。mappedMethods 中存放了异常和处理异常的方法的对应关系 for (Class<? extends Throwable> mappedException : this.mappedMethods.keySet()) { if (mappedException.isAssignableFrom(exceptionType)) { matches.add(mappedException); } } // 不为空说明有方法处理异常 if (!matches.isEmpty()) { // 按照匹配程度从小到大排序 matches.sort(new ExceptionDepthComparator(exceptionType)); // 返回处理异常的方法 return this.mappedMethods.get(matches.get(0)); } else { return null; } }从源代码看出：getMappedMethod()会首先找到可以匹配处理异常的所有方法信息，然后对其进行从小到大的排序，最后取最小的那一个匹配的方法(即匹配度最高的那个)。
写一个抛出异常的类测试
Person.java
public class Person { private Long id; private String name; // 省略 getter/setter 方法 }ExceptionController.java(抛出一场的类)
@RestController @RequestMapping("/api") public class ExceptionController { @GetMapping("/resourceNotFound") public void throwException() { Person p=new Person(1L,"SnailClimb"); throw new ResourceNotFoundException(ImmutableMap.of("person id:", p.getId())); } }源码地址：https://github.com/Snailclimb/springboot-guide/tree/master/source-code/basis/springboot-handle-exception-improved
- ubuntu用户现在已经确切的了解到关于unity8集成到ubuntu桌面的相关计划。ubuntu桌面其实还并没有引起更多开发者的足够关注，不过现在这种状况正在得到更快的改变。Canonical的ubuntu桌面团队经理，Will Cooke，最近谈到了关于unity桌面的一些未来规划，以及未来几个ubuntu版本的计划。可能已经有许多ubuntu用户，已经发现，有越来越多的ubuntu开发者正在把他们的精力放在了ubuntu的移动端平台上，与此同时，关注桌 面端ubuntu的开发者要比平常少了不少。这或许是因为，大家都认为，来自ubuntu touch的大量改进和优化，形成的成果最终也会汇集到桌面端吧！其实吧，并不是所有的人都相信，现在在ubuntu touch上的桌面环境，会让未来的ubuntu桌面端一样变得更强大，而且，所说的未来其实也没多久远！事实上，要比大家想想的更为靠近！下一代Ubuntu LTS会默认采用unity8ubuntu的移动平台正在使用unity8 ，这货不同于当前桌面端使用的unity7，毕竟人家使用了很多期待中的有趣特性。ubuntu的开发人员几乎花费了超过2年的时间，就是为了能让 unity8能在ubuntu phone和ubuntu touch上完美运行，所以为了这样的目的，几乎付出了他们的所有努力。Canonical的新晋桌面团队经理，Will Cooke ，详细的解释unity8的发展蓝图，即将发布的ubuntu14.10的默认桌面依然会是unity7 ，unity8仅会以开发者预览版的形式作为一种可选项予以提供，ubuntu15.04仍然会将unity7作为默认桌面，不过unity8将作为可替 代选项予以提供，而将unity8作为默认桌面最有可能是在ubuntu15.10发行版中。Will说“可能”，是因为他不确定，在那之前，会不会发生一些不可预料的事情影响进度，ubuntu开发人员可能会准备好，也可能不会，所以看情况了。不过，可以确定的是，unity8一定会作为ubuntu16.04这个长期支持版的默认使用桌面。为什么ubuntu新桌面是如此特别？你可能会认为，unity8仅仅是一种桌面环境的升级罢了，而事实上，它远不只如此！由于unity8的构建方式，当开发者发布新的应用和更新，终端用户会更快速的收到相关的包版本，而不用再等待新版本的ubuntu来获取相关的重要应用或者二进制包！“通常来说，新版本的ubuntu发布，会伴随有新版本的相关应用更新，当然也必然包含有重要的安全更新和BUG修复，但是为了获得相关更新，你不 得不耐心的等待新版本的ubuntu的发布，以及相关应用的重大更新才可以。而新版本的unity8工作机制，保证了开发者将其应用更新实时推送到客户端 面前而不需要等待，毫无疑问，终端用户会因此而获益多多！”Will Cooke这样说。社区阻力依然存在对Canonical来说，unity8是一个重大的改变，也正是因为如此，从一开始，就感受到来自社区的巨大质疑和阻力，这也是众所周知的！幸运 的是，unity8项目从一开始还是被绝大多数人认可，当然了也有人认为unity7才是最棒的，而unity8是个失败品。这也是没办法的事了！Canonical如今提供了使用unity8的另一个镜像（点击浏览），我们称之为“NEXT”！这是一个live CD，能够展现大概的功能，不过这货是基于一个超大号的tablet！期待吧，愚蠢的地球人，希望明年有足够的时间让大家用上新版本的unity！谢谢阅读，希望能帮到大家，请继续关注脚本之家，我们会努力分享更多优秀的文章。
- 区块链在网络信任体系中的应用研究
- DeadBolt 勒索软件再次发难，威联通正展开调查
- MySQL数据库安装过程中常见错误的解决方案
- 手机720分辨率（探索高清晰度的手机世界）
- 常用恶意软件分析方法及工具汇总
- 容器化应用程序的灾难恢复准备差距
- 提高MySQL数据库查询速度的六条策略
- 小新教你如何进行电脑新机验机（掌握电脑新机验机的步骤和注意事项，尽在小新的教程中）
- 少打一个字母，多个 PyPI 软件包引入恶意依赖
随便看看
- Copyright © 2025 Powered by 使用枚举简单封装一个优雅的 Spring Boot 全局异常处理！,创站工坊 滇ICP备2023006006号-44sitemap