Spring中使用ExceptionHandler转换异常后无法捕获自定义异常的问题

问题根源 #

1. 初始实现错误：返回异常而非抛出
   第一个异常处理器直接return new MyCustomException("test")，这只是把异常对象作为HTTP响应体返回，并没有触发Spring的异常传播机制，第二个处理器根本不会感知到这个异常。

2. 修改后仍失败的常见原因

   • Spring未加载第二个处理器：ServiceErrorHandling类不在Spring的组件扫描路径范围内（比如不在启动类的包/子包下），导致该处理器未被初始化。
   • 自定义异常类型问题：如果MyCustomException继承自Exception（受检异常），但第一个处理器方法未声明throws MyCustomException，Spring无法正确传播异常。
   • 异常处理器优先级冲突：存在其他全局异常处理器提前拦截了MyCustomException。

解决方案 #

1. 修正自定义异常类型

让自定义异常继承RuntimeException，避免受检异常的传播限制：

public class MyCustomException extends RuntimeException {
    public MyCustomException(String message) {
        super(message);
    }
}

2. 正确抛出自定义异常

第一个处理器必须抛出异常，而非返回：

@RestControllerAdvice
public class GatewayErrorHandling {

    @ExceptionHandler(FeignException.class)
    public void handleFeignException(FeignException e) {
        throw new MyCustomException("调用外部网关失败: " + e.getMessage());
    }
}

3. 确保第二个处理器被Spring加载

检查ServiceErrorHandling所在包是否在Spring Boot的组件扫描范围内（默认扫描启动类所在包及子包），如果不在，可通过@ComponentScan指定扫描路径，或调整类的位置。

4. 优化第二个处理器（可选）

如果需要返回自定义HTTP响应，可调整返回类型，同时确保异常被正确捕获：

@RestControllerAdvice
public class ServiceErrorHandling {

    @ExceptionHandler(MyCustomException.class)
    public ResponseEntity<String> handleMyCustomException(MyCustomException e) {
        System.out.println("exception catched: " + e.getMessage());
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
    }
}

额外排查点 #

• 查看Spring启动日志，确认ServiceErrorHandling是否被初始化（日志会打印加载的Bean信息）。
• 检查是否存在其他全局异常处理类（如实现ErrorController的类）提前拦截了MyCustomException。

内容的提问来源于stack exchange，提问作者cucuru