全局ExceptionHandler（handlerInvalidArgument）未生效，移入Controller后正常

以下是几种常见原因及对应解决方案：

1. 全局异常处理器类未添加注解 #

你的advice包下的异常处理类必须标注@RestControllerAdvice（返回JSON响应时）或@ControllerAdvice注解，否则Spring无法识别它为全局异常处理器，自然不会生效。而Controller内部的@ExceptionHandler属于局部处理器，仅对当前Controller生效，所以移过去能正常工作。

解决：在advice包的异常处理类顶部添加注解：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(InvalidArgumentException.class) // 替换为你要处理的异常类型
    public ResponseEntity<Object> handlerInvalidArgument(InvalidArgumentException e) {
        // 你的响应逻辑
    }
}

2. Spring包扫描范围未覆盖advice包 #

Spring Boot默认扫描启动类所在包及其所有子包。如果你的advice包不在这个扫描范围内，该类不会被Spring容器加载，处理器也就无法生效。

解决：

• 调整包结构，将advice包放在启动类所在包的子目录下；
• 或者在启动类上显式指定扫描范围：

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

3. 异常类型匹配不精确 #

确认@ExceptionHandler注解指定的异常类型，是否与实际抛出的异常完全匹配（包括是否为子类关系）。比如如果实际抛出的是AuthenticationException的子类，但你的处理器只声明处理AuthenticationException，可能存在匹配问题（不过这种情况概率较低，因为Spring会向上匹配父类异常）。

解决：检查实际抛出的异常类，调整@ExceptionHandler的参数类型，确保能覆盖目标异常。

4. 多处理器优先级冲突 #

如果项目中存在多个全局异常处理器，可能因为优先级问题导致你的处理器未被调用。局部Controller的处理器优先级高于全局处理器，所以移到Controller后能生效。

解决：在全局异常处理器类上添加@Order注解，设置更高优先级（数值越小优先级越高）：

@RestControllerAdvice
@Order(1)
public class GlobalExceptionHandler {
    // ...
}

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