当前位置：首页 > news >正文

使用spring boot实现异常的统一返回

news 2025/8/29 15:13:27

在这个前后端分离的时代，一个统一的数据格式非常重要。本次我们实现用spring boot实现一下返回给前端数据的统一格式，不再出现服务器500的错误。

新建一个spring boot项目，并导入knife4j的依赖。

写一个controller控制器，用来是实现测试http的请求

@RestController
public class TestController {@GetMapping("/test")
public  String test(){
int i=1/0;return "一个test测试请求";
}
}

发送请求测试：

异常的统一主要依赖于两个注解：
@ControllerAdvice：

Controller增强器，给controller层增加统一的操作和处理

@ExceptionHander

捕获controller抛出的异常，并进行处理；

自定义异常处理：

1、自定义一个类Result，用来实现返回给前端的统一格式：

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Result<T> implements Serializable {private static final long serialVersionUID = 1L;
private Integer code;
private String message;
private T data;
}

2、创建一个类ResultException，继承RuntimeException异常

@Data
@AllArgsConstructor
@NoArgsConstructor
public class ResultException extends RuntimeException{private Integer code;private String message;
}

3、创建一个VoResultException 类，用来实现具体的逻辑：

@RestControllerAdvice
public class VoResultException {//    自定义异常处理类
@ExceptionHandler(ResultException.class)
public Result errorResult(ResultException resultException){
return new Result(resultException.getCode(),resultException.getMessage(),null);
}}

@RestControllerAdvice注解是@ControllerAdvice和@ResponseBody注解的结合，标识返回的数据是json类型

至此，我们就实现了全部的工作。现在，在你想要抛出异常的地方直接使用即可（直接抛出ResultException异常）

@GetMapping("/test")
public  String test(){throw new ResultException(10001,"测试异常");}

发送请求测试：

可以返回了统一的数据，但是这个异常是我们自定义的。所以不能处理程序中的错误

如下图这个错误：

@GetMapping("/test")
public  String test(){int i=1/0;throw new ResultException(10001,"测试异常");}

测试请求：

由于这个异常是在程序运行中出现的，属于RunException异常，我们自定义的异常不能够捕获到。这时，我们可以在自定义的异常处理器VoResultException类中再加入全局异常处理器。

如下所示：

@RestControllerAdvice
public class VoResultException {
//    自定义异常处理类
@ExceptionHandler(ResultException.class)
public Result errorResult(ResultException resultException){
return new Result(resultException.getCode(),resultException.getMessage(),null);
}//全局异常处理类@ExceptionHandler(Exception.class)public Result error(Exception e){return new Result(1001,e.getMessage(),null);}}

加入了全局异常处理时，抛出的RunException异常就可以自动捕获了。

小插曲：

@ExceptionHandler(ResultException.class)注解里面是要捕获的异常的类型，下面的方法参数中也一定要传入与这个类型一样的类队象或者满足继承关系（这一点是非常重要的，不然它不能自动捕获异常）

因为有人还是搞不懂，这个关系，私下里问我。我再一次修改了，这一次更加详细：

在使用 @ExceptionHandler 注解时，注解中的类对象并不一定要与方法参数的对象类型完全一样，但是要满足以下条件：