Spring Boot 3.1.x中统一包装所有响应的惯用实现方案

针对你需要全局将所有ResponseEntity响应体包装到ResponseWrapper的需求，最符合Spring Boot最佳实践的方案是使用**ResponseBodyAdvice**——这是Spring MVC官方提供的响应拦截扩展点，专门用于在响应序列化前统一修改响应内容，同时能完整获取原响应的状态码。

实现步骤 #

1. 实现ResponseBodyAdvice全局拦截类 #

这个类会拦截所有返回ResponseEntity的接口，自动将响应体包装为ResponseWrapper，无需修改原有接口代码。

import org.springframework.core.MethodParameter;
import org.springframework.http.HttpStatus;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;

@ControllerAdvice
public class GlobalResponseWrapperAdvice implements ResponseBodyAdvice<Object> {

    @Override
    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
        // 仅处理返回类型为ResponseEntity的接口
        return ResponseEntity.class.isAssignableFrom(returnType.getParameterType());
    }

    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType,
                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
                                  ServerHttpRequest request, ServerHttpResponse response) {
        if (body instanceof ResponseEntity<?>) {
            ResponseEntity<?> originalResponse = (ResponseEntity<?>) body;
            HttpStatus status = originalResponse.getStatusCode();
            Object originalBody = originalResponse.getBody();

            // 用ResponseWrapper包装原响应体
            ResponseWrapper<Object> wrappedBody = new ResponseWrapper<>(status, originalBody);

            // 返回包装后的ResponseEntity，保留原状态码
            return ResponseEntity.status(status).body(wrappedBody);
        }
        return body;
    }
}

2. 处理特殊场景（可选） #

如果存在不需要包装的接口，或者原响应体为null的情况，可以补充逻辑：

• 排除指定接口：自定义注解标记不需要包装的接口/类，在supports方法中跳过

  // 自定义排除注解
  @Target({ElementType.METHOD, ElementType.TYPE})
  @Retention(RetentionPolicy.RUNTIME)
  public @interface SkipResponseWrapper {}
  
  // 修改supports方法
  @Override
  public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
      // 跳过带有@SkipResponseWrapper注解的方法或类
      if (returnType.hasMethodAnnotation(SkipResponseWrapper.class) ||
          returnType.getContainingClass().isAnnotationPresent(SkipResponseWrapper.class)) {
          return false;
      }
      return ResponseEntity.class.isAssignableFrom(returnType.getParameterType());
  }
  

• 处理空响应体：如果原ResponseEntity的body为null（比如ResponseEntity.noContent()），可以添加空值判断避免包装异常。

方案优势 #

• 无侵入性：无需修改现有数千个接口的代码，全局自动生效
• 符合Spring规范：属于Spring MVC官方推荐的扩展方式，而非hack方案
• 状态码保留完整：能准确获取原ResponseEntity的HttpStatus，不会丢失状态信息
• 灵活性强：可通过注解轻松排除特定接口，适配复杂业务场景

对比你提到的自定义继承ResponseEntity的方案，该方式无需全局替换代码和导入，避免了大量重复劳动和潜在的代码冲突风险。

内容的提问来源于stack exchange，提问作者el n00b