ControllerAdvice不处理引发的异常

基础概念

@ControllerAdvice 是 Spring 框架中的一个注解，用于全局处理控制器层的异常。它允许开发者在一个集中的地方定义异常处理逻辑，从而避免在每个控制器方法中重复编写异常处理代码。

类型与应用场景

全局异常处理：适用于所有控制器抛出的异常。
特定异常处理：可以通过 @ExceptionHandler 注解指定处理特定类型的异常。
特定控制器异常处理：结合 @ControllerAdvice 和 @ExceptionHandler 可以针对特定控制器进行异常处理。

常见问题及原因

1. `@ControllerAdvice` 不处理引发的异常

原因分析：

未正确配置：可能没有在类上添加 @ControllerAdvice 注解。
包扫描问题：Spring 可能没有扫描到包含 @ControllerAdvice 的类。
异常类型不匹配：@ExceptionHandler 方法可能没有正确指定要处理的异常类型。
优先级问题：可能存在其他更具体的异常处理器优先处理了异常。

解决方案

1. 确保正确配置 `@ControllerAdvice`

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception ex) {
        ErrorResponse errorResponse = new ErrorResponse(ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

2. 检查包扫描路径

确保 Spring 配置文件或启动类中包含了正确的包扫描路径。

@SpringBootApplication(scanBasePackages = "com.example")
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

3. 明确指定异常类型

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(SpecificException.class)
    public ResponseEntity<ErrorResponse> handleSpecificException(SpecificException ex) {
        ErrorResponse errorResponse = new ErrorResponse(ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
    }
}

4. 调整异常处理优先级

如果存在多个异常处理器，可以通过 @Order 注解调整优先级。

@ControllerAdvice
@Order(Ordered.HIGHEST_PRECEDENCE)
public class HighPriorityExceptionHandler {
    // ...
}

示例代码

假设有一个控制器抛出了一个自定义异常 CustomException：

@RestController
public class ExampleController {

    @GetMapping("/example")
    public String example() throws CustomException {
        throw new CustomException("This is a custom exception.");
    }
}

对应的 @ControllerAdvice 处理器：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(CustomException.class)
    public ResponseEntity<ErrorResponse> handleCustomException(CustomException ex) {
        ErrorResponse errorResponse = new ErrorResponse(ex.getMessage());
        return new ResponseEntity<>(errorResponse, HttpStatus.BAD_REQUEST);
    }
}

通过以上配置，当 ExampleController 抛出 CustomException 时，GlobalExceptionHandler 将会捕获并处理该异常。