引言

在开发Spring Boot应用时，我们经常面临着不同的控制器方法需要处理各种不同类型的响应结果，以及在代码中分散处理异常可能导致项目难以维护的问题。你是否曾经遇到过在不同地方编写相似的返回格式，或者在处理异常时感到有些混乱？这些看似小问题的积累，实际上可能对项目产生深远的影响。统一结果返回和统一异常处理并非只是为了规范代码，更是为了提高团队的协作效率、降低项目维护的难度，并使代码更易于理解和扩展。

本文的目的是帮助你更好地理解和应用Spring Boot中的统一结果返回和统一异常处理。通过详细的讨论和实例演示，我们将为你提供一套清晰的指南，让你能够在自己的项目中轻松应用这些技术，提高代码质量，减轻开发压力。

统一结果返回

统一结果返回是一种通过定义通用的返回格式，使所有的响应结果都符合同一标准的方法。这有助于提高代码的一致性，减少重复代码的编写，以及使客户端更容易理解和处理API的响应。统一结果返回不仅规范了代码结构，还能提高团队协作效率，降低项目维护的难度。

接下来让我们一起看看在SpringBoot中如何实现统一结果返回。

1. 定义通用的响应对象

当实现统一结果返回时，需要创建一个通用的响应对象，定义成功和失败的返回情况，并确保在接口中使用这个通用返回对象。

@Setter  
@Getter  
public class ResultResponse<T> implements Serializable {  private static final long serialVersionUID = -1133637474601003587L;  /**  * 接口响应状态码  */  private Integer code;  /**  * 接口响应信息  */  private String msg;  /**  * 接口响应的数据  */  private T data;
}    

2. 定义接口响应状态码

统一结果返回的关键之一是规定一套通用的状态码。这有助于客户端更容易地理解和处理 API 的响应，同时也为开发者提供了一致的标准。通常，一些 HTTP 状态码已经被广泛接受，如：

• 200 OK：表示成功处理请求。
• 201 Created：表示成功创建资源。
• 204 No Content：表示成功处理请求，但没有返回任何内容。

对于错误情况，也可以使用常见的 HTTP 状态码，如：

• 400 Bad Request：客户端请求错误。
• 401 Unauthorized：未授权访问。
• 404 Not Found：请求资源不存在。
• 500 Internal Server Error：服务器内部错误。

除了 HTTP 状态码外，你还可以定义自己的应用程序特定状态码，以表示更具体的情况。确保文档中清晰地说明了每个状态码所代表的含义，使开发者能够正确地解释和处理它们。

public enum StatusEnum {  SUCCESS(200 ,"请求处理成功"),  UNAUTHORIZED(401 ,"用户认证失败"),  FORBIDDEN(403 ,"权限不足"),  SERVICE_ERROR(500, "服务器去旅行了，请稍后重试"),  PARAM_INVALID(1000, "无效的参数"),  ;  public final Integer code;  public final String message;  StatusEnum(Integer code, String message) {  this.code = code;  this.message = message;  }  }

3. 定义统一的成功和失败的处理方法

定义统一的成功和失败的响应方法有助于保持代码一致性和规范性，简化控制器逻辑，提高代码复用性，降低维护成本，提高可读性，促进团队协作，以及更便于进行测试。

/**  * 封装成功响应的方法  * @param data 响应数据  * @return reponse  * @param <T> 响应数据类型  */  
public static <T> ResultResponse<T> success(T data) {  ResultResponse<T> response = new ResultResponse<>();  response.setData(data);  response.setCode(StatusEnum.SUCCESS.code);  return response;  
}  /**  * 封装error的响应  * @param statusEnum error响应的状态值  * @return  * @param <T>  */  
public static <T> ResultResponse<T> error(StatusEnum statusEnum) {  return error(statusEnum, statusEnum.message);  
}  /**  * 封装error的响应  可自定义错误信息* @param statusEnum error响应的状态值  * @return  * @param <T>  */  
public static <T> ResultResponse<T> error(StatusEnum statusEnum, String errorMsg) {