SpringBoot异常处理：全局异常处理与自定义异常实例

如何处理SpringBoot中的异常？

在开发过程中，异常处理是确保应用程序稳定性和健壮性的关键部分。尤其在SpringBoot中，异常处理显得尤为重要，因为一个良好的异常处理机制能够提升用户体验，减少错误信息的混乱，甚至可以帮助我们更好地定位问题所在。在这篇文章中，我将带你一起探索如何在SpringBoot项目中优雅地处理异常。

1. 理解SpringBoot中的异常处理

在开始之前，让我们先了解一下SpringBoot是如何处理异常的。Spring Boot自带了一些基础的异常处理功能。比如说，如果你不小心访问了一个不存在的网址，它就会给你弹出一个默认的错误页面，告诉你出问题了。然而，这样的处理方式并不总是符合我们的需求。我们需要更灵活、更定制化的异常处理方案来适应不同的业务场景。

2. 使用@ControllerAdvice和@ExceptionHandler

首先，我们要介绍的是`@ControllerAdvice`和`@ExceptionHandler`这两个注解。它们是SpringBoot中处理全局异常的利器。
- @ControllerAdvice：这是一个用于定义全局异常处理器的注解。通过将这个注解应用到一个类上，你可以定义一些方法来捕获并处理特定类型的异常。
- @ExceptionHandler：这是与`@ControllerAdvice`结合使用的注解，用来指定哪些方法应该处理特定类型的异常。
示例代码：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(value = {NullPointerException.class})
    public ResponseEntity<String> handleNullPointerException(NullPointerException ex) {
        System.out.println("Caught NullPointerException");
        return new ResponseEntity<>("Null Pointer Exception occurred", HttpStatus.BAD_REQUEST);
    }
    @ExceptionHandler(value = {IllegalArgumentException.class})
    public ResponseEntity<String> handleIllegalArgumentException(IllegalArgumentException ex) {
        System.out.println("Caught IllegalArgumentException");
        return new ResponseEntity<>("Illegal Argument Exception occurred", HttpStatus.BAD_REQUEST);
    }
}

在这个例子中，我们定义了一个全局异常处理器，它能捕捉两种类型的异常：`NullPointerException` 和 `IllegalArgumentException`。当这两种异常发生时，程序会返回相应的错误信息和状态码给客户端。

3. 自定义异常类

有时候，标准的Java异常不足以满足我们的需求。这时，自定义异常类就派上用场了。自定义异常类不仅可以让代码更具可读性，还能帮助我们更好地组织和分类异常。
示例代码：

public class CustomException extends RuntimeException {
    private int errorCode;
    public CustomException(int errorCode, String message) {
        super(message);
        this.errorCode = errorCode;
    }
    // Getter and Setter for errorCode
}

然后，在控制器层中抛出这些自定义异常：

@RestController
public class MyController {
    @GetMapping("/test")
    public String test() {
        throw new CustomException(1001, "This is a custom exception");
    }
}

4. 使用ErrorController接口

除了上述方法外，SpringBoot还提供了`ErrorController`接口，允许我们自定义错误处理逻辑。通过实现该接口，我们可以控制当错误发生时应返回的具体内容。
示例代码：

import org.springframework.boot.web.servlet.error.ErrorController;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
@Controller
public class CustomErrorController implements ErrorController {
    @Override
    public String getErrorPath() {
        return "/error";
    }
    @RequestMapping("/error")
    public ResponseEntity<String> handleError() {
        return new ResponseEntity<>("Custom error page", HttpStatus.NOT_FOUND);
    }
}

在这个例子中，我们定义了一个新的错误处理页面，当发生错误时，用户将会看到一个友好的提示页面而不是默认的错误页面。
---
以上就是我在处理SpringBoot项目中的异常时的一些经验分享。希望这些技巧能帮助你在实际开发中更加得心应手。当然，每个项目都有其独特之处，所以灵活运用这些知识才是王道。在处理异常的过程中，记得保持代码的简洁性和可维护性，这样你的项目才能走得更远！