SpringBoot未捕获异常处理技巧

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《Spring Boot 全局异常未捕获自定义异常解决办法》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

本文详解为何 `@ControllerAdvice` 异常处理器未捕获自定义 `ApiException`，核心原因在于组件扫描路径配置缺失或类路径未被 Spring 管理，并提供完整可运行的修复方案。

在 Spring Boot 中，@ControllerAdvice 类必须被 Spring 容器成功加载并注册为 Bean，才能生效。你提供的 GeneralExceptionHandler 代码逻辑本身是正确的（继承关系、注解使用、方法签名均符合 Spring MVC 异常处理规范），但若该类未被 Spring 扫描到，则整个异常处理链路将“静默失效”——即抛出 ApiException 后直接返回 500 错误，而不会进入 @ExceptionHandler 方法。

✅ 正确做法：确保组件可被扫描

Spring Boot 默认仅扫描主启动类所在包及其子包。若 GeneralExceptionHandler 或 ApiException 位于主启动类包之外的路径（例如 com.example.exception 而启动类在 com.example.app），则需显式配置扫描范围：

@SpringBootApplication
@ComponentScan(basePackages = {
    "com.example.app",
    "com.example.exception",  // 显式包含异常处理器所在包
    "com.example.controller"
})
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

? 更推荐的做法是：将 @ControllerAdvice 类与启动类置于同一包或其子包下（如 com.example.app.advice.GeneralExceptionHandler），避免额外配置。

⚠️ 其他关键注意事项

• 移除 static 修饰符：@ExceptionHandler 方法不能是静态的。Spring 依赖反射调用实例方法，static 将导致该方法被完全忽略：

  // ❌ 错误：static 会导致 handler 失效
  @ExceptionHandler(ApiException.class)
  public static ResponseEntity