先说说啥叫全局异常处理

你平时写Spring项目，代码里到处抛异常。

有时候一个小bug，页面直接炸掉。

那用户kan到的就是一堆500错误，心里嘀咕：这玩意儿怎么这么不稳？

其实我们完全Ke以把这些异常统一捕获，然后返回个友好的JSON。

这就叫全局异常处理。

听起来好像hen靠谱。

但实际操作起来代码量暴涨，维护成本直线上升。

所以大家dou在找geng优雅的方案。

先说这个Zui常用的方式。

我们只需要写一个类，标上@ControllerAdvice，然后在里面写几个@ExceptionHandler方法。

比如：

/**
 * 全局异常拦截器
 */
@RestControllerAdvice
public class GlobalExceptionHandler {
    // 捕获所有未被捕获的运行时异常
    @ExceptionHandler
    public Result handleRuntimeException {
        // 记录日志...
        return Result.error,
                            ex.getMessage);
    }
    // 捕获自定义业务异常
    @ExceptionHandler
    public Result handleSBException {
        return Result.error, ex.getMessage);
    }
}

kan，这里用了Result这个统一返回体。

Result是干嘛的？它把前后端交互的JSON结构给规范了。

先把概念捋清楚：

接口 BaseErrorInfoInterface   →   定义错误码规范
枚举 ResultCodeEnum            →   实现接口，统一管理错误码
自定义异常 SBException         →   运行时异常，携带业务错误码和消息
全局异常拦截 GlobalExceptionHandler  →  捕获所有异常，返回统一响应
统一返回体 Result              →   规范前后端交互 JSON 结构

Ru果你不想用注解，又或者想在过滤器层面统一处理，那就实现HandlerExceptionResolver接口吧。

写个类实现它，然后在Spring容器里注册成bean。

代码大概长这样：

public class MyExceptionResolver implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest request,
                                         HttpServletResponse response,
                                         Object handler,
                                         Exception ex) {
        // 根据不同异常类型返回不同的ModelAndView或JSON
        // ...
        return new ModelAndView;
    }
}

不过实话实说这种方式相对老旧，而且要自己去拼装响应体，稍显麻烦。

AOP 在Spring里随处可见，切面同样Ke以拦截抛出的异常。

@Around 切点配合 ProceedingJoinPoint.proceed 包裹住业务方法，就Neng捕获并转换异常。

@Aspect
@Component
public class ExceptionAspect {
    @Around")
    public Object around throws Throwable {
        try {
            return pjp.proceed;
        } catch  {
            // 转换为统一响应
            return Result.error, e.getMessage);
        } catch  {
            // 未知异常走这里
            return Result.error,
                                "系统内部错误");
        }
    }
}

好处是Ke以把所有控制层的方法一次性包起来不用每个Controllerdou加注解。缺点是调试时堆栈信息可Neng会被“包装”掉，需要注意日志打印。

@ControllerAdvice：Zui直观、Zui符合Spring官方推荐；适合大多数项目；兼容Spring MVC和Restful风格。

HandlerExceptionResolver：老派但强大；适合需要在DispatcherServlet之前拦截的场景；配置略繁琐。

AOP 切面：灵活度高；Ke以跨层次捕获；但对新人来说阅读门槛稍高。

Eclipse/IDEA 新建一个common包，把Result、ResultCodeEnum、BaseErrorInfoInterface这些放进去。

Sbexception 放在exception子包下。

The GlobalExceptionHandler 放在controller.advice目录下这样一眼就Nengkan出来是全局拦截器。哈哈，你懂的，就是要有层次感呀！

偶尔有人问：我把博客写好了却发现百度根本不收录，这咋整？

其实原因hen多，我跟你唠唠常见的几条：

内容质量不足：Ru果文章太短、重复率高、或者没有独特价值，搜索引擎会打折扣。咱们这篇文章可是1500+字，还带代码示例，算是高质量啦！

Noindex标签或robots.txt阻挡："noindex" 会直接告诉搜索引擎别收录。检查一下你的页面头部有没有误加了这个标签。哈哈，不对不对，我刚才说错了是 那种情况别忘了去掉哦！

Sitemap缺失或提交不到位：Sitemap 是给搜索引擎递交网址列表的“邀请函”。没有的话，它们只Neng靠爬虫自己发现，一般会慢一点。建议手动提交一次让它知道你真的存在！

Eureka 注册中心本身不会帮你捕获业务异常，但我们Ke以在每个微服务内部使用上面的方案，然后再配合Feign 的fallback机制，把熔断信息也包装成统一Result返回给调用方。

@FeignClient
public interface OrderServiceClient {
    @GetMapping
    Result getOrder Long id);
}
@Component
class OrderServiceFallback implements OrderServiceClient {
    @Override
    public Result getOrder {
        return Result.error,
                            "订单服务暂不可用，请稍后重试");
    }
}

Bingo，这样即使微服务挂掉，也不会让调用方直接抛500，而是得到一个可读的错误信息。咱们说实话，这才是企业级项目该有的姿势啊！

#1 把BaseErrorInfoInterface和ResultCodeEnum敲定下来一个枚举列出所有业务错误码；

#2 实现SBException，让它持有错误码和消息；

#3 写GlobalExceptionHandler，用@RestControllerAdvice标记；里面写几种常见异常对应的方法；

#4 把Result作为统一返回体封装好；记得加上时间戳、请求路径之类的信息，让前端调试geng轻松；

Lombok Neng省去Getter/Setter，大幅提升代码简洁度；Swagger 注解让API文档自动生成，同时还Neng把错误码展示出来一举两得！

@ApiModel
@Data
@AllArgsConstructor
public class Result {
    private int code;
    private String message;
    private T data;
    public static  Result success {
        return new Result<>,
                            "成功", data);
    }
}

# Spring实现全局异常处理主要靠三招：@ControllerAdvice/@ExceptionHandler、实现HandlerExceptionResolver、AOP切面；

# 建议首选@ControllerAdvice，因为它Zui简洁且与Spring生态兼容度Zui高；

# 配套要Zuo好错误码体系以及统一返回体，这样前后端才Neng心有灵犀一点通。

我们写完代码后可别忘了跑单元测试和集成测试，把各种业务场景dou走一遍，否则上线后真遇到奇葩报错，你又得手忙脚乱地补坑…)

—— 好啦，就酱紫~ 咱们下回见 👋🏻👋🏻👋🏻