Spring Boot 全局异常处理

在使用Spring Boot开发应用时，异常处理是一个不可忽视的重要环节。合理的异常处理能够帮助我们更好地管理应用的错误，提高用户体验和系统的可维护性。本文将介绍如何在Spring Boot中实现全局异常处理。

一、全局异常处理的必要性

在一个实际的应用中，面对用户的请求，服务器可能会因为多种原因而抛出异常，比如用户输入错误、数据库连接失败、外部接口调用异常等。若不加处理，这些异常可能导致应用崩溃、错误信息直接暴露给用户，从而影响用户体验。通过全局异常处理，我们可以集中管理异常处理逻辑，提高代码的可读性和可维护性。

二、使用@ControllerAdvice实现全局异常处理

在Spring Boot中，可以使用@ControllerAdvice注解来创建一个全局异常处理类。这个类可以捕获所有控制器抛出的异常。

1. 创建异常类

首先，我们可以定义一个自定义异常类，例如CustomException，用于描述特定的业务异常：

public class CustomException extends RuntimeException {
    private String message;

    public CustomException(String message) {
        this.message = message;
    }

    @Override
    public String getMessage() {
        return message;
    }
}

2. 创建全局异常处理类

接下来，我们创建一个全局异常处理类，并使用@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;
import org.springframework.web.bind.annotation.ResponseStatus;

// 自定义全局异常处理类
@ControllerAdvice
public class GlobalExceptionHandler {

    // 处理自定义异常
    @ExceptionHandler(CustomException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ResponseEntity<String> handleCustomException(CustomException ex) {
        return new ResponseEntity<>(ex.getMessage(), HttpStatus.BAD_REQUEST);
    }

    // 处理其他异常
    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ResponseEntity<String> handleGenericException(Exception ex) {
        return new ResponseEntity<>("服务器内部错误: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

三、在控制器中抛出异常

在我们的控制器中，可以抛出上述自定义的异常：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class SampleController {

    @GetMapping("/test")
    public String test() {
        // 模拟业务异常
        if (true) {
            throw new CustomException("自定义异常发生！");
        }
        return "Hello, World!";
    }
}

四、运行示例

当我们访问/test接口时，如果抛出CustomException，就会触发全局异常处理，返回400错误以及异常信息。如果是其他类型的异常，则会返回500错误。

五、总结

通过使用@ControllerAdvice结合@ExceptionHandler，我们可以实现Spring Boot应用中的全局异常处理。这种方式不仅让代码更加整洁，还方便了后期的维护和扩展。同时，自定义异常类的使用让我们能够对不同的业务异常进行分类处理，提高了系统的健壮性。

希望本文能够帮助你更好地理解Spring Boot中的异常处理机制，提升你的开发技能。