当使用 `@controlleradvice` 和 `@exceptionhandler` 处理自定义异常（如 `apiexception`）时，若异常未被捕获，通常并非逻辑错误，而是 spring 扫描路径缺失或配置不当所致。本文详解正确实现方式及关键排查点。

在 Spring Boot 中，@ControllerAdvice 是实现全局异常统一处理的核心机制，但其生效前提是：该类必须被 Spring 容器成功扫描并注册为 Bean。从您提供的代码来看，GeneralExceptionHandler 的逻辑本身是正确的——继承自 Exception 的 ApiException 可被 @ExceptionHandler(ApiException.class) 精确匹配，且 @DeleteMapping 中调用的服务方法明确抛出该异常。问题几乎必然出在 组件扫描范围（component scan）未覆盖 GeneralExceptionHandler 所在包。

✅ 正确配置步骤

1. 确认 @ControllerAdvice 类位于主启动类的扫描路径下
   Spring Boot 默认仅扫描主启动类（标注 @SpringBootApplication 的类）所在包及其子包。若 GeneralExceptionHandler 位于 com.example.exception，而启动类在 com.example.app，则需确保二者包结构满足父子关系，或显式指定扫描路径：

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

2. 移除 @ExceptionHandler 方法上的 static 修饰符
   ⚠️ 这是关键错误！@ExceptionHandler 方法必须是非静态的实例方法，否则 Spring 无法通过代理调用它：

   @ControllerAdvice
   public class GeneralExceptionHandler {
       private static final Logger logger = LoggerFactory.getLogger(GeneralExceptionHandler.class);
   
       // ❌ 错误：static 方法无法被 Spring AOP 拦截
       // @ExceptionHandler(ApiException.class)
       // public static ResponseEntity<Object> handleExceptions(ApiException e) { ... }
   
       // ✅ 正确：改为实例方法
       @ExceptionHandler(ApiException.class)
       public ResponseEntity<Object> handleExceptions(ApiException e) {
           logger.info("Exception handled: {} with HTTP status: {}", e.getMessage(), e.getHttpStatus());
           return ResponseEntity.status(e.getHttpStatus()).body(e.getMessage());
       }
   }

3. 确保 ApiException 继承自 RuntimeException（推荐）
   虽然继承 Exception 在技术上可行，但 Spring MVC 默认仅对 未声明检查型异常（即非 throws 显式抛出）的运行时异常自动传播至异常处理器。当前 deleteSubjectType() 声明了 throws ApiException，而控制器未声明该异常，会导致编译通过但运行时被包装为 UndeclaredThrowableException，从而绕过 @ExceptionHandler。
   最佳实践：让 ApiException 继承 RuntimeException，并移除 throws 声明：

   public class ApiException extends RuntimeException { // ✅ 改为 RuntimeException
       private final HttpStatus httpStatus;
   
       public ApiException(String message, HttpStatus httpStatus) {
           super(message);
           this.httpStatus = httpStatus;
       }
   
       public HttpStatus getHttpStatus() {
           return httpStatus;
       }
   }

   对应服务层修改：

   

   Miller CSV TSV JSON 数据处理器

   Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

   下载

   @Override
   public Boolean deleteSubjectType(int subjectTypeId) {
       SubjectType subjectType = subjectTypeRepository.findById(subjectTypeId)
               .orElseThrow(() -> new ApiException("Subject Type Id not found", HttpStatus.NOT_FOUND));
       return true;
   }

4. 验证是否启用 Web MVC 配置
   确保项目依赖 spring-boot-starter-web，且未禁用默认 MVC 配置（如 @EnableWebMvc 会覆盖 Spring Boot 自动配置，需手动注册 HandlerExceptionResolver）。

? 快速验证方法

• 在 GeneralExceptionHandler 构造函数中添加日志或断点，确认其是否被实例化；
• 使用 @PostConstruct 打印日志，验证 Bean 是否加载；
• 启动应用后访问 /actuator/beans（需启用 Actuator），搜索 generalExceptionHandler，确认其存在于 IOC 容器中。

✅ 总结

全局异常处理器失效的三大主因：
? @ControllerAdvice 类未被 Spring 扫描（最常见）；
? @ExceptionHandler 方法误加 static（直接导致失效）；
? 自定义异常继承 Exception 且被显式 throws，破坏 Spring 的异常传播链。

修正以上三点后，ApiException 将被精准捕获，返回预期的 HTTP 状态码与响应体。