Spring Boot全局异常处理指南

原创于 2025-10-30 09:30:39 发布 · 579 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #java

朝花夕拾篇专栏收录该内容

109 篇文章

订阅专栏

01 引言

SpringBoot的全局异常处理已经被各大技术大牛讲烂了，使用@ControllerAdvice、@ExceptionHandler来处理全局异常。本节我们将借鉴框架提供的异常处理机制，完善全局异常的处理，并聊聊背后的故事。

02 全局异常处理重现

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BindException.class)
    public ResponseEntity<Map<String, Object>> handleValidationExceptions(BindException ex) {
        return ResponseEntity.badRequest().body(buildErrors(ex.getFieldError().getDefaultMessage()));
    }

    @ExceptionHandler(RuntimeException.class)
    public ResponseEntity<Map<String, Object>> handleException(RuntimeException ex) {
        return ResponseEntity.badRequest().body(buildErrors(ex.getMessage()));
    }

    @ExceptionHandler(Exception.class)
    public ResponseEntity<Map<String, Object>> handleException(Exception ex) {
        return ResponseEntity.badRequest().body(buildErrors(ex.getMessage()));
    }

    private Map<String, Object> buildErrors(String msg) {
        Map<String, Object> body = new HashMap<>();
        body.put("success", false);
        body.put("msg", msg);
        body.put("data", null);
        return body;
    }
}

@ControllerAdvice是 Spring MVC 中一个非常强大且实用的注解，它的核心作用是提供全局的、跨多个控制器的增强处理。就像一个"全局拦截器"或"切面"。

@ExceptionHandler主要用来处理对应的异常，其中@ExceptionHandler(Exception.class)是兜底异常，匹配不到的异常最终都会走到里面。

在很多博主分享的文章中，都会说这里需要定义所有需要处理的异常。但是具体有哪些异常，始终没有参考的东西。

按照小编的设想，异常的处理如果只关心异常的信息提示，那只要分出e.getMessage()能不能取出异常信息，凡是不能取出的都需要特殊处理，如：

BindException：

e.getBindingResult().getFieldErrors()[0].getDefaultMessage
MissingServletRequestParameterException

e.getParameterName()获取缺失的字段。

其他的只需要兜底的异常即可。

03 框架自带全局异常

全局异常处理的异常也有被有些大牛单独列出来过，心想这么多异常谁能记住。我只关心能不能取到异常信息就好。

直到前两天整理SpringBoot配置的时候，看到了SpringBoot框架自带了一个异常处理器，几乎枚举了所有常见的异常.

ResponseEntityExceptionHandler：

org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler

如果打算细分的朋友，可以参考这个类定制属于自己的异常处理器了。

04 异常解析器

configureHandlerExceptionResolvers

原本全局异常的处理，上面的内容已经足够了。但是分享SpringBoot的WebMvcConfigurer配置项的时候，才发现原来配置项也可以进行异常的统一处理。

这两个方法在配置项中已经介绍的很清楚了，这里不再赘述。

我们自定义异常处理器处理全局异常：

public class AHandlerExceptionResolver implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        if (ex instanceof RuntimeException) {
            //...
        }else if (ex instanceof BindException) {
            //...
        }else {
            //...
        }
        return new ModelAndView();
    }
}