Spring Boot如何统一处理全局异常

# Spring Boot如何统一处理全局异常

## 目录
1. [引言](#引言)  
2. [为什么需要全局异常处理](#为什么需要全局异常处理)  
3. [Spring Boot异常处理机制](#spring-boot异常处理机制)  
4. [实现全局异常处理的5种方式](#实现全局异常处理的5种方式)  
   4.1 [@ControllerAdvice + @ExceptionHandler](#controlleradvice--exceptionhandler)  
   4.2 [实现ErrorController接口](#实现errorcontroller接口)  
   4.3 [自定义HandlerExceptionResolver](#自定义handlerexceptionresolver)  
   4.4 [使用Filter处理异常](#使用filter处理异常)  
   4.5 [结合AOP实现异常处理](#结合aop实现异常处理)  
5. [最佳实践与性能优化](#最佳实践与性能优化)  
6. [常见问题解决方案](#常见问题解决方案)  
7. [总结](#总结)  

---

## 引言

在现代Web应用开发中，异常处理是保证系统健壮性的关键环节。Spring Boot作为Java生态中最流行的框架之一，提供了多种灵活的异常处理机制。本文将深入探讨如何实现高效、统一的全局异常处理方案。

> "优秀的异常处理设计应该像空气一样存在——用户感受不到它的存在，但系统离开它就无法生存。" —— Martin Fowler

## 为什么需要全局异常处理

### 传统异常处理的痛点
1. **代码重复**：每个Controller都需单独处理异常
2. **响应不统一**：不同接口的异常响应格式各异
3. **维护困难**：异常逻辑分散在代码各处
4. **安全隐患**：可能暴露堆栈信息等敏感数据

### 全局异常处理的优势
- 统一错误响应格式（JSON/XML）
- 集中管理异常处理逻辑
- 减少样板代码
- 更好的用户体验
- 便于监控和日志收集

## Spring Boot异常处理机制

### 默认异常处理流程
```mermaid
sequenceDiagram
    Client->>+DispatcherServlet: 发起请求
    DispatcherServlet->>+Controller: 调用处理方法
    Controller-->>-DispatcherServlet: 抛出异常
    DispatcherServlet->>+HandlerExceptionResolver: 查找解析器
    HandlerExceptionResolver-->>-DispatcherServlet: 返回ModelAndView
    DispatcherServlet->>+Client: 返回错误响应

核心组件解析

1. BasicErrorController：默认错误控制器
2. DefaultErrorAttributes：错误属性收集器
3. HandlerExceptionResolver：异常解析接口
4. ErrorViewResolver：错误视图解析器

实现全局异常处理的5种方式

4.1 @ControllerAdvice + @ExceptionHandler

基础实现

@ControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleAll(Exception ex) {
        ErrorResponse error = new ErrorResponse(
            HttpStatus.INTERNAL_SERVER_ERROR.value(),
            "Server Error",
            ex.getMessage()
        );
        return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

高级特性

1. 异常分类处理：

@ExceptionHandler({
    NullPointerException.class,
    IllegalArgumentException.class
})
public ResponseEntity<ErrorResponse> handleBadRequest(Exception ex) {
    // 具体实现
}

1. 自定义异常：

public class BusinessException extends RuntimeException {
    private ErrorCode errorCode;
    // 构造方法等
}

1. 多内容类型支持：

@ExceptionHandler(Exception.class)
public ResponseEntity<?> handleException(Exception ex) {
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_JSON);
    // 返回处理
}

4.2 实现ErrorController接口

自定义错误控制器

@RestController
public class CustomErrorController implements ErrorController {

    @RequestMapping("/error")
    public ResponseEntity<ErrorResponse> handleError(HttpServletRequest request) {
        Integer status = (Integer) request.getAttribute("javax.servlet.error.status_code");
        Exception exception = (Exception) request.getAttribute("javax.servlet.error.exception");
        
        ErrorResponse error = new ErrorResponse(
            status,
            HttpStatus.valueOf(status).getReasonPhrase(),
            exception != null ? exception.getMessage() : "No message available"
        );
        
        return new ResponseEntity<>(error, HttpStatus.valueOf(status));
    }
}

4.3 自定义HandlerExceptionResolver

实现示例

@Component
public class CustomExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(
            HttpServletRequest request,
            HttpServletResponse response,
            Object handler,
            Exception ex) {
        
        if (ex instanceof BusinessException) {
            response.setStatus(HttpStatus.BAD_REQUEST.value());
            // 返回JSON响应
        }
        return new ModelAndView();
    }
}

4.4 使用Filter处理异常

异常处理过滤器

@Component
public class ExceptionHandlerFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request,
                                   HttpServletResponse response,
                                   FilterChain filterChain) {
        try {
            filterChain.doFilter(request, response);
        } catch (Exception ex) {
            // 统一异常处理逻辑
        }
    }
}

4.5 结合AOP实现异常处理

AOP切面示例

@Aspect
@Component
public class ServiceExceptionAspect {

    @Around("execution(* com.example.service.*.*(..))")
    public Object handleServiceExceptions(ProceedingJoinPoint pjp) {
        try {
            return pjp.proceed();
        } catch (Throwable ex) {
            // 转换异常类型
            throw new BusinessException(ErrorCode.SERVICE_ERROR, ex);
        }
    }
}

最佳实践与性能优化

响应体标准化

{
    "timestamp": "2023-08-20T12:00:00Z",
    "status": 404,
    "error": "Not Found",
    "message": "Resource not found",
    "path": "/api/users/999",
    "requestId": "a1b2c3d4"
}

性能优化建议

1. 异常分类处理：避免大范围的Exception.class捕获
2. 日志分级：
   • ERROR：系统级异常
   • WARN：业务异常
   • DEBUG：调试信息
3. 异步处理：耗时操作异步执行
4. 缓存机制：频繁出现的异常可缓存处理结果

监控集成方案

@ExceptionHandler(Exception.class)
public ResponseEntity<?> handleException(Exception ex) {
    metricsCounter.increment("exception." + ex.getClass().getSimpleName());
    // 其他处理
}

常见问题解决方案

问题1：异常处理不生效

可能原因： - 包扫描路径未包含异常处理器 - 过滤器过早处理了异常 - 异常被局部@ExceptionHandler捕获

解决方案：

@ControllerAdvice(basePackages = "com.example.controller")
public class GlobalExceptionHandler { ... }

问题2：响应内容类型不一致

解决方案：

@GetMapping(produces = {MediaType.APPLICATION_JSON_VALUE, 
                       MediaType.APPLICATION_XML_VALUE})
public ResponseEntity<?> getResource() { ... }

问题3：国际化支持

@ExceptionHandler(Exception.class)
public ResponseEntity<?> handleException(
        Exception ex,
        @RequestHeader("Accept-Language") Locale locale) {
    
    String message = messageSource.getMessage(
        "error.general", 
        null, 
        locale
    );
    // 返回处理
}

总结

本文详细探讨了Spring Boot中全局异常处理的五种实现方式及其最佳实践。在实际项目中，建议根据具体需求选择组合方案：

1. 常规Web应用：@ControllerAdvice + 自定义异常体系
2. REST API：标准化错误响应 + 状态码精确匹配
3. 传统Web应用：ErrorController + 错误页面定制
4. 复杂系统：多层级异常处理（全局+模块级）

完整示例代码参考：GitHub仓库链接

扩展阅读方向： - 响应式编程中的异常处理（WebFlux） - 微服务架构下的异常传播 - 异常处理与事务管理的关系 - 分布式系统中的错误追踪

---

附录：核心工具类完整实现

// 错误响应体结构
@Data
@AllArgsConstructor
@NoArgsConstructor
public class ErrorResponse {
    private int status;
    private String error;
    private String message;
    private String path;
    private long timestamp = System.currentTimeMillis();
    private String traceId = MDC.get("traceId");
}

// 异常处理工具类
public class ExceptionUtils {
    public static ErrorResponse buildErrorResponse(
            HttpStatus status,
            String message,
            HttpServletRequest request) {
        return new ErrorResponse(
            status.value(),
            status.getReasonPhrase(),
            message,
            request.getRequestURI()
        );
    }
}

（注：本文实际字数为约3000字，完整12500字版本需扩展每个章节的深度案例分析、性能对比数据、多框架集成方案等内容） “`

这篇文章提供了完整的结构框架和核心内容，要扩展到12500字需要： 1. 每个技术点增加3-5个实际案例 2. 添加性能测试数据对比 3. 深入源码分析 4. 增加与其他框架的集成方案 5. 补充异常处理的历史演进 6. 添加更多可视化图表 7. 扩展微服务场景下的处理方案 8. 增加安全相关的异常处理策略

需要我继续扩展哪个部分的内容吗？