Spring Boot替代JAX-RS拦截器实现响应对象包装的方案咨询

看起来你之前在JEE7里靠JAX-RS拦截器搞定了响应包装的需求，现在转到Spring Boot想找个替代方案，试了HandlerInterceptorAdapter和ResponseBodyAdvice都遇到了卡点对吧？我来给你捋捋正确的实现方式。

为什么你之前的尝试没成功？ #

• HandlerInterceptorAdapter的局限：它的postHandle方法里，modelAndView是给视图渲染用的，RestController返回的对象根本不会存在这里，而且这个阶段响应可能已经开始写入了，没法直接替换响应体内容。
• ResponseBodyAdvice的用法问题：你之前把泛型指定成了Susu，导致beforeBodyWrite只能返回Susu类型，自然没法换成你的Wrapper对象。

正确的实现：用ResponseBodyAdvice灵活包装 #

其实ResponseBodyAdvice就是Spring官方推荐用来在响应序列化前修改响应体的工具，只需要调整一下泛型和逻辑就行，步骤如下：

1. 先定义你的包装类

比如一个通用的Wrapper，用来封装状态码、消息和数据：

public class Wrapper<T> {
    private int code;
    private String message;
    private T data;

    // 构造方法、getter、setter
    public Wrapper(T data) {
        this.code = 200;
        this.message = "请求成功";
        this.data = data;
    }

    // 可以再加其他构造方法，比如处理错误场景
}

2. 实现正确的ResponseBodyAdvice

把泛型改成Object，这样就能返回包装后的对象了，还能通过supports方法控制哪些请求需要被包装：

@ControllerAdvice
public class ResponseWrapperAdvice implements ResponseBodyAdvice<Object> {

    @Override
    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
        // 这里可以精确过滤：比如只处理SusuController的方法
        return returnType.getContainingClass().equals(SusuController.class);
        // 如果想全局生效，直接return true就行
    }

    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType,
                                  Class<? extends HttpMessageConverter<?>> selectedConverterType,
                                  ServerHttpRequest request, ServerHttpResponse response) {
        // 避免重复包装：如果已经是Wrapper类型就直接返回
        if (body instanceof Wrapper) {
            return body;
        }
        // 把原始的Susu对象包装成Wrapper
        return new Wrapper<>(body);
    }
}

注意事项 #

• 如果你的控制器有返回String类型的方法，可能会触发StringHttpMessageConverter导致序列化问题，这时候可以手动把Wrapper转成JSON字符串返回，或者调整消息转换器的优先级。不过你的场景是返回Susu对象，暂时不用操心这个。
• supports方法可以做更精细的控制：比如只处理特定注解标记的方法，或者特定返回类型的方法，根据你的需求调整就行。

为什么不用HandlerInterceptor？ #

HandlerInterceptor更适合处理请求前后的通用逻辑，比如日志记录、权限校验，它没法直接干预响应体的序列化过程，而ResponseBodyAdvice正好卡在消息转换器处理响应体之前，完全符合你在Jackson序列化前包装的需求，是Spring里做这件事的首选方案。

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