springboot 全局异常捕获不起作用解决与排查方案

最新推荐文章于 2025-03-17 00:17:48 发布

qq_36913208

最新推荐文章于 2025-03-17 00:17:48 发布

阅读量1.4w

点赞数 2

分类专栏： Java # Spring 文章标签： java spring

本文链接：https://blog.youkuaiyun.com/qq_36913208/article/details/104025830

版权

Spring 同时被 2 个专栏收录

4 篇文章

订阅专栏

Java

2 篇文章

订阅专栏

本文详细记录了解决IDEA中GlobalExceptionHandler类不起作用的问题，包括调整编译器排除设置、确保异常正确抛出及匹配、参与编译等关键步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

如题：

使用的是idea，我也不知道为什么，我建立完 GlobalExceptionHandler类之后就被idea给坑了

GlobalExceptionHandler类的小图标显示有一把叉叉，很不起眼的那种，后来一查才知道，原来是被编译器给排除了，气死我了，我今天一个晚上全搞这个问题去了，记录一下

解决方案：

File > Setting > Build > Compiler > Excludes, 把右边对应的显示叉叉的类移除即可

经过几个小时的努力终于爬出了这个坑，总结一下全局异常捕获失效的常见错误

springboot 扫描包的时候出了问题，自己去扫包的地方检查清除，你的idea中GlobalExceptionHandler如果起作用了就会有这个小图标

在这里插入图片描述

你并没有将异常抛出，（很基础的问题）
```
throw new ApiException()  //记得抛出
```
你自定义的GlobalExceptionHandler类中没有与抛出的Exception相匹配的 Exception
类没有参与编译，可能被编译器排除了，（我就是被这点坑了）

排查错误的时候多打调试输出，把输出看仔细，你也可以在GlobalExceptionHandler类里面写Systom.out.println 看看对应的 Exception在抛出后能不能接到，比如这样：

@RestControllerAdvice
public class GlobalExceptionHandler {

    private Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(NullPointerException.class)
    public Result NullPointer(NullPointerException ex){
        System.out.println("捕获到了NullPointerException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR_NULL);
    }

    @ExceptionHandler(ClassCastException.class)
    public Result ClassCastException(ClassCastException ex){
        System.out.println("捕获到了ClassCastException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR_CLASS_CAST);
    }

    @ExceptionHandler(IOException.class)
    public Result IOException(IOException ex){
        System.out.println("捕获到了IOException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR_IO);
    }

    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    public Result HttpRequestMethodNotSupportedException(HttpRequestMethodNotSupportedException ex){
        System.out.println("捕获到了HttpRequestMethodNotSupportedException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR_MOTHODNOTSUPPORT);
    }

    @ExceptionHandler(ApiException.class)
    public Result ApiException(ApiException ex) {
        System.out.println("捕获到了ApiException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ex.getStatus(),ex.getMessage());
    }

    @ExceptionHandler(RuntimeException.class)
    public Result RuntimeException(RuntimeException ex){
        System.out.println("捕获到了RuntimeException");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR_RUNTION);
    }

    @ExceptionHandler(Exception.class)
    public Result exception(Exception ex){
        System.out.println("捕获到了Exception");
        logger.error(ex.getMessage(),ex);
        return Result.error(ApiResultEnum.ERROR);
    }

}

@ExceptionHandler(NullPointerException.class) 里面的参数的意思是，当你在外部抛出NullPointerException的异常时，这个注解下面对应的方法就会执行，然后我们就能在里面第一行写一个输出语句调试一下，如果不输出，那肯定是这个异常没有被捕获到，