三种方式处理SpringBoot全局异常

在SpringBoot开发web项目时,异常处理是必不可少的一部分。在应用中,异常可能出现在任何地方,例如在控制层,服务层,数据访问层等等。如果不对异常进行处理可能会导致应用崩溃或者出现未知的错误。因此对于异常的处理是非常重要的。

什么是SpringBoot应用异常处理?

Spring Boot应用异常处理是指在Spring Boot应用中对异常进行捕获和处理的机制。当应用发生异常时,可以通过异常处理机制来捕获异常并进行相应的处理,例如返回友好的错误信息给用户,记录异常日志等。

Spring Boot应用异常处理的实现原理?

Spring Boot应用异常处理的实现原理主要依赖于Spring框架提供的异常处理机制。在Spring Boot应用中,可以通过自定义异常处理器来捕获和处理异常。

具体实现步骤如下:

  • 创建一个自定义的异常类,继承自Exception或RuntimeException,用于表示应用中的特定异常情况。
  • 创建一个全局异常处理器,使用@ControllerAdvice注解标记,并在类中定义异常处理方法,使用@ExceptionHandler注解标记该方法可以处理的异常类型。
  • 在异常处理方法中,可以根据具体的异常类型进行相应的处理,例如返回友好的错误信息给用户、记录异常日志等。
  • 在Spring Boot应用中,可以通过配置文件或者注解的方式将自定义的异常处理器注册到应用中。

Spring Boot应用异常处理的优点

  • 统一异常处理:通过自定义异常处理器,可以统一处理应用中的异常,提供统一的错误信息给用户,提高用户体验。
  • 异常日志记录:可以在异常处理器中记录异常日志,方便开发人员定位和解决问题。
  • 可扩展性:可以根据具体的业务需求,自定义异常处理器,实现特定的异常处理逻辑。

Spring Boot应用异常处理的缺点

  • 异常处理逻辑可能会增加代码复杂性,需要谨慎设计和实现。
  • 如果异常处理不当,可能会导致应用出现安全漏洞或者信息泄露的风险。

三种处理方式

使用@ControllerAdvice注解

@ControllerAdvice 是 SpringBoot 提供的一个注解,用于定义全局异常处理器。在使用@ControllerAdvice 注解时,需要使用@ExceptionHandler 注解来指定处理的异常类型。

@ControllerAdvice // 定义一个全局异常处理器
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class) //指定了需要处理的异常类型为Exception 当应用中出现Exception类型的异常时,就会调用handleException方法来处理异常
    public ResponseEntity<String> handleException(Exception e) {
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
    }
}

使用@ExceptionHandler 注解

还可以在控制器中使用@ExceptionHandler 注解来处理异常。这种方式的好处是可以针对不同的控制器方法定义不同的异常处理器。

@RestController
public class UserController {

    @Autowired
    private UserService userService;

    @ExceptionHandler(UserNotFoundException.class)
    public ResponseEntity<String> handleUserNotFoundException(UserNotFoundException e) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(e.getMessage());
    }

    @GetMapping("/users/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        User user = userService.getUserById(id);
        if (user == null) {
            throw new UserNotFoundException("User not found");
        }
        return ResponseEntity.ok(user);
    }
}

在上面的例子中,在控制器中定义了一个 handleUserNotFoundException 方法,用于处理 UserNotFoundException 类型的异常。当 getUser 方法中出现 UserNotFoundException 类型的异常时,就会调用 handleUserNotFoundException 方法来处理异常。

使用 HandlerExceptionResolver 接口

除了使用@ControllerAdvice 注解和@ExceptionHandler 注解外,还可以实现 HandlerExceptionResolver 接口来处理异常。这种方式比较灵活,可以自定义异常处理器的实现方式。

public class GlobalExceptionHandler implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        ModelAndView mav = new ModelAndView();
        mav.addObject("exception", ex);
        mav.setViewName("error");
        return mav;
    }
}

在上面的例子中,我们实现了 HandlerExceptionResolver 接口,并重写了 resolveException 方法来处理异常。当应用中出现异常时,就会调用 resolveException 方法来处理异常。

posted @ 2025-09-19 22:29  小郑[努力版]  阅读(16)  评论(0)    收藏  举报