Spring MVC 完整生命周期和异常处理流程图

先要明白

javascript 复制代码

// 1. 用户发来请求: localhost:8080/user/1

// 2. 处理器映射器(HandlerMapping)的工作
// 它会找到对应的Controller和方法
@GetMapping("/user/{id}")  
public User getUser(@PathVariable Long id) {
    return userService.getById(id);
}

// 3. 处理器适配器(HandlerAdapter)的工作
// - 把URL中的"1"转成Long类型的1 (类型转换)
// - 检查id是否为空、是否是正数 (数据验证)
// - 把转换好的参数传给controller方法 (参数解析)

客户端/浏览器前端控制器 (DispatcherServlet) 处理器映射器 (HandlerMapping) 处理器适配器 (HandlerAdapter) 控制器 (Controller) 服务层 (Service) 异常通知器 (@RestControllerAdvice) 异常解析器 (HandlerExceptionResolver) 前端控制器初始化 1. initMultipartResolver() 初始化文件上传解析器 2. initLocaleResolver() 初始化地区解析器 3. initThemeResolver() 初始化主题解析器 4. initHandlerMappings() 初始化处理器映射器 5. initHandlerAdapters() 初始化处理器适配器 6. initHandlerExceptionResolvers() 初始化异常解析器请求处理阶段 1. 发送HTTP请求 (例如：POST /serve/onSale/1) 2. getHandler() 查找处理器根据URL匹配HandlerMapping 返回HandlerExecutionChain 返回处理器执行链 3. getHandlerAdapter() 获取处理器适配器适配器负责: 1.参数解析 2.类型转换 3.数据验证返回适配器业务处理阶段 4. handle(request, response, handler) 调用控制器方法调用服务层方法返回处理结果返回ModelAndView 返回ModelAndView 业务处理出现异常可能抛出: 1. ForbiddenOperationException 2. CommonException 3. 其他异常异常被@RestControllerAdvice捕获委托给异常解析器处理异常解析过程: 1. 判断异常类型 2. 选择处理策略 3. 转换为统一响应处理FeignException 处理CommonException 处理普通Exception alt [Feign调用异常] [自定义业务异常] [其他异常] 返回处理结果返回错误响应 alt [正常业务流程] [异常流程] 响应处理阶段 processDispatchResult() 处理ModelAndView 返回处理结果处理错误视图返回统一错误格式 alt [成功响应] [错误响应] 核心组件说明： 1. DispatcherServlet：Spring MVC的核心，统一的请求处理入口 2. HandlerMapping：负责URL与处理器的映射 3. HandlerAdapter：负责适配不同类型的处理器 4. Controller：处理具体的业务逻辑 5. @RestControllerAdvice：统一的异常处理切面 6. HandlerExceptionResolver：负责具体的异常处理策略客户端/浏览器前端控制器 (DispatcherServlet) 处理器映射器 (HandlerMapping) 处理器适配器 (HandlerAdapter) 控制器 (Controller) 服务层 (Service) 异常通知器 (@RestControllerAdvice) 异常解析器 (HandlerExceptionResolver)
重要说明响应处理阶段异常处理阶段业务处理阶段请求处理阶段前端控制器初始化阶段找到未找到支持不支持成功失败 Feign异常业务异常其他异常是否前端控制器
DispatcherServlet 处理器映射器
HandlerMapping 处理器适配器
HandlerAdapter 异常通知器
@RestControllerAdvice 异常解析器
HandlerExceptionResolver 构建响应对象返回HTTP响应检查异常类型 FeignException处理 CommonException处理 Exception处理是否内部调用内部异常处理外部异常处理设置异常头信息构建错误响应调用服务层方法是否成功返回处理结果抛出异常查找处理器接收HTTP请求获取处理器适配器返回404 适配器是否支持调用控制器方法返回错误信息初始化文件上传解析器
initMultipartResolver 前端控制器初始化初始化地区解析器
initLocaleResolver 初始化主题解析器
initThemeResolver 初始化处理器映射器
initHandlerMappings 初始化处理器适配器
initHandlerAdapters 初始化异常解析器
initHandlerExceptionResolvers 开始结束

我用生活中的例子解释 @RestControllerAdvice 的工作原理：

想象一个大型商场的客服中心：

DispatcherServlet就像商场的总服务台

负责接收所有顾客的需求并分配给相应的专柜处理

@RestControllerAdvice就像商场的客服中心

设立在商场的一个统一位置
专门处理各个专柜出现的问题和投诉

举个具体场景：

顾客在商场购物的流程：

1. 正常流程：
顾客 -> 总服务台(DispatcherServlet) -> 专柜(Controller) -> 购买商品

2. 出现问题时：
专柜(Controller)出现问题 -> 客服中心(@RestControllerAdvice)接手处理 -> 给顾客一个合理解释

用代码表示：

java 复制代码

// 这就像设立一个统一的客服中心
@RestControllerAdvice
public class GlobalExceptionHandler {
    
    // 这就像专门处理"商品缺货"的客服人员
    @ExceptionHandler(ProductOutOfStockException.class)
    public ResponseEntity<String> handleOutOfStock(ProductOutOfStockException e) {
        // 返回友好提示："非常抱歉，商品暂时缺货，预计3天后到货"
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                           .body("商品暂时缺货，预计3天后到货");
    }
    
    // 这就像处理"商品价格异常"的客服人员
    @ExceptionHandler(PriceException.class)
    public ResponseEntity<String> handlePriceError(PriceException e) {
        // 返回友好提示："价格显示异常，请稍后重试"
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                           .body("价格显示异常，请稍后重试");
    }
}

为什么能拦截异常？

就像商场里：

所有专柜都在商场里面
客服中心在商场的入口处
一旦专柜出问题，就会按照商场规定，统一转到客服中心处理

在Spring中：

DispatcherServlet(总服务台)知道有这个@RestControllerAdvice(客服中心)的存在
当Controller(专柜)抛出异常时
DispatcherServlet就会把异常转给@RestControllerAdvice处理

关键点：

它不是拦截，而是异常发生后的统一处理
Spring框架帮我们做了这个转发操作
这样我们就不用在每个Controller里写重复的异常处理代码

客户端 DispatcherServlet Controller @RestControllerAdvice 异常通知类 @ExceptionHandler 异常处理方法正常请求流程 1. 发送HTTP请求 2. 转发到Controller 异常发生和处理流程 3. 业务处理过程中抛出异常 @RestControllerAdvice的作用 1. 是@ControllerAdvice的特殊形式 2. 会自动扫描所有Controller 3. 集中处理所有异常 4. 异常被@RestControllerAdvice捕获 @ExceptionHandler的作用 1. 指定要处理的异常类型 2. 根据异常类型匹配处理方法 3. 将异常转换为友好响应 5. 根据异常类型找到对应的处理方法处理微服务调用异常处理业务异常处理未知异常 alt [FeignExcept- ion异常] [CommonExc- eption异常] [其他Exceptio- n] 响应处理 6. 返回处理后的Result对象 7. 转换为HTTP响应返回重要说明： 1. @RestControllerAdvice相当于异常的"统一接待处" 2. @ExceptionHandler相当于不同类型异常的"专门处理窗口" 3. 整个过程自动完成，使异常处理从业务代码中解耦客户端 DispatcherServlet Controller @RestControllerAdvice 异常通知类 @ExceptionHandler 异常处理方法