SpringMVC中如何优雅地实现Request请求体的多次读取

最新推荐文章于 2026-06-04 09:42:38 发布

原创

最新推荐文章于 2026-06-04 09:42:38 发布 · 331 阅读

标签

#SpringMVC #Request #ContentCachingRequestWrapper

1. 为什么需要重复读取Request请求体？

在Web开发中，我们经常会遇到需要多次读取HttpServletRequest请求体的情况。比如在处理日志记录、参数校验、权限验证等场景时，可能需要多次访问请求体内容。但原生HttpServletRequest的InputStream设计上只能被读取一次，一旦读取完毕就无法再次获取数据。

这个问题在实际开发中经常让人头疼。想象一下，你在Controller里想先打印请求日志，再处理业务逻辑，结果发现日志拦截器已经把流读完了，业务代码拿到的就是个空流。或者你想在Filter里做参数校验，校验完发现Controller里拿不到数据了。这种场景下，我们就需要一种机制，能够重复读取请求体。

2. 使用ContentCachingRequestWrapper实现请求体缓存

2.1 ContentCachingRequestWrapper原理分析

Spring框架提供了一个现成的解决方案：ContentCachingRequestWrapper。这个类继承自HttpServletRequestWrapper，内部维护了一个字节数组作为缓存。当第一次读取请求体时，它会将数据保存到这个缓存中，后续读取都从这个缓存获取。

它的核心方法是getContentAsByteArray()，这个方法会返回缓存的请求体字节数组。需要注意的是，这个缓存是在第一次读取请求体后才填充的，所以如果你直接调用getContentAsByteArray()而没有先读取过请求体，可能会得到空数组。

2.2 具体实现步骤

要实现请求体的重复读取，我们需要创建一个Filter来包装原始的HttpServletRequest：

@Component
public class CachingRequestBodyFilter extends GenericFilterBean {
    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain chain) 
        throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) servletRequest;
        ContentCachingRequestWrapper wrappedRequest = new ContentCachingRequestWrapper(request);
        chain.doFilter(wrappedRequest, servletResponse);
    }
}

然后在Controller中就可以这样使用：