当前位置：首页 > news >正文

Spring的异常处理机制详解

news 2026/5/11 20:26:47

在Spring Boot MVC架构中，如果Service方法中的异常没有被捕获也没有被抛出，异常的处理流程如下：

1.默认异常处理流程

@RestControllerpublicclassUserController{@AutowiredprivateUserServiceuserService;@GetMapping("/user/{id}")publicUsergetUser(@PathVariableLongid){// 如果Service抛出异常且没有被捕获returnuserService.findById(id);// 异常会向上传播}}@ServicepublicclassUserService{publicUserfindById(Longid){// 这里发生异常（比如NullPointerException）// 但没有try-catch，也没有声明throwsreturnuserRepository.findById(id).orElseThrow(()->newRuntimeException("User not found"));}}

2.异常的传播路径

Service层异常 → Controller层 → DispatcherServlet → 框架处理

具体处理方式：

3.运行时异常（RuntimeException）

@ServicepublicclassUserService{publicvoidprocess(){// 运行时异常会自动向上传播intresult=10/0;// ArithmeticException}}

处理结果：

异常会传播到Controller
如果没有@ExceptionHandler处理，会到DispatcherServlet
最终返回HTTP 500状态码

4.受检异常（Checked Exception）

@ServicepublicclassUserService{publicvoidreadFile(){// 编译错误：必须处理或声明抛出// FileReader fr = new FileReader("file.txt");}publicvoidreadFile2()throwsIOException{// 必须声明throwsFileReaderfr=newFileReader("file.txt");}}

关键区别：

受检异常：编译时会报错，必须处理
运行时异常：编译通过，运行时才暴露

5.Spring的异常处理机制

A. Controller级别的@ExceptionHandler

@RestControllerAdvicepublicclassGlobalExceptionHandler{@ExceptionHandler(RuntimeException.class)publicResponseEntity<String>handleRuntimeException(RuntimeExceptione){returnResponseEntity.status(500).body("Service Error: "+e.getMessage());}}

B. Service层使用声明式事务

@Service@TransactionalpublicclassUserService{publicvoidupdateUser(Useruser){// 事务方法中的异常会导致事务回滚userRepository.save(user);thrownewRuntimeException("Test rollback");}}

6.实际影响和最佳实践

❌不推荐的做法：

@ServicepublicclassUserService{publicvoidriskyMethod(){// 异常被"吞掉"，调用方不知道出错try{// 可能抛出异常的操作}catch(Exceptione){// 空的catch块，不记录也不抛出}}}

✅推荐的最佳实践：

方案1：统一异常处理

@ServicepublicclassUserService{publicUserfindById(Longid){returnuserRepository.findById(id).orElseThrow(()->newUserNotFoundException("User not found with id: "+id));}}// 自定义业务异常publicclassUserNotFoundExceptionextendsRuntimeException{publicUserNotFoundException(Stringmessage){super(message);}}

方案2：使用AOP统一处理

@Aspect@ComponentpublicclassServiceExceptionAspect{@AfterThrowing(pointcut="execution(* com.example.service.*.*(..))",throwing="ex")publicvoidhandleServiceException(Exceptionex){// 记录日志、监控等log.error("Service层异常: ",ex);}}

方案3：响应式异常处理

@ServicepublicclassUserService{@TransactionalpublicUsercreateUser(UserDTOdto){try{// 业务逻辑returnuserRepository.save(user);}catch(DataIntegrityViolationExceptione){thrownewBusinessException("用户已存在",e);}catch(Exceptione){log.error("创建用户失败",e);thrownewSystemException("系统错误，请稍后重试",e);}}}