Spring Boot 全局捕获异常

最新推荐文章于 2025-06-04 11:46:59 发布

阅读量1k

点赞数

CC 4.0 BY-SA版权

分类专栏： Spring Boot 文章标签： spring boot 异常捕获

本文链接：https://blog.youkuaiyun.com/cckevincyh/article/details/78981961

Spring Boot 专栏收录该内容

47 篇文章

订阅专栏

本文介绍如何在SpringBoot项目中实现全局异常捕获并优雅地返回JSON格式的错误信息，通过@ControllerAdvice注解来创建一个统一的异常处理类。

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

Spring Boot 全局捕获异常

假如我们在代码中写错了：
这里写图片描述
然后我们访问的时候就会出现：

然而我们并不想把错误抛给用户看，这个时候就需要用到全局捕获异常。

@ExceptionHandler 表示拦截异常
• @ControllerAdvice 是 controller 的一个辅助类，最常用的就是作为全局异常处理的切面类
• @ControllerAdvice 可以指定扫描范围
• @ControllerAdvice 约定了几种可行的返回值，如果是直接返回 model 类的话，需要使用 @ResponseBody 进行 json 转换
o 返回 String，表示跳到某个 view
o 返回 modelAndView
o 返回 model + @ResponseBody


package com.cc.springboot;

import java.util.HashMap;
import java.util.Map;

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(RuntimeException.class)
    @ResponseBody // 拦截返回是 json返回结果
    public Map<String, Object> exceptionHandler() {
        Map<String, Object> result=new HashMap<String, Object>();
        result.put("code","500");
        result.put("msg","亲,系统错误,请稍后重试....");
        return result;
    }

}

再次访问发现：
这里写图片描述