先要明白
@GetMapping ( "/user/{id}" )
public User getUser ( @PathVariable Long id ) {
return userService. getById ( id) ;
}
客户端/浏览器
前端控制器
(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)接手处理 -> 给顾客一个合理解释
用代码表示:
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler ( ProductOutOfStockException . class )
public ResponseEntity < String > handleOutOfStock ( ProductOutOfStockException e) {
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
异常处理方法