为什么HttpServletRequest 的输入流（InputStream）只能读取一次？有什么更好的替代方案？

HttpServletRequest 中的输入流 (InputStream) 只能读取一次，是因为它是基于底层网络流实现的，而网络流（如HTTP请求的输入流）通常只能按顺序读取数据。当数据被读取之后，流的指针会被推进到数据的末尾，后续的读取操作将无法重新访问已经读取的数据。

具体原因如下：

1. 输入流是单向的：InputStream 设计为一次性读取，它的工作原理类似于管道，数据流过后就无法再读取。HTTP 请求中的输入流，特别是请求体中的数据，在第一次读取后就不能回退。

2. 性能考虑：HTTP 请求中的数据通常很大，允许流多次读取会增加额外的复杂性和性能开销。为了保证性能，输入流在读取数据后会被消耗掉。

替代方案：

如果你希望多次读取请求体（例如日志记录、后续处理等），可以使用以下几种替代方案：

1. HttpServletRequestWrapper：
   你可以创建一个自定义的 HttpServletRequestWrapper 类，重写 getInputStream() 或 getReader() 方法，在第一次读取时将数据缓存到内存中，之后的读取操作直接从缓存中获取数据。这样，你就可以多次读取请求体。

   示例代码：

   public class CachedBodyHttpServletRequestWrapper extends HttpServletRequestWrapper {
       private byte[] body;
   
       public CachedBodyHttpServletRequestWrapper(HttpServletRequest request) throws IOException {
           super(request);
           InputStream inputStream = request.getInputStream();
           this.body = inputStream.readAllBytes();  // 读取请求体到内存
       }
   
       @Override
       public ServletInputStream getInputStream() {
           return new ServletInputStream() {
               private ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(body);
   
               @Override
               public int read() {
                   return byteArrayInputStream.read();
               }
           };
       }
   
       public byte[] getBody() {
           return body;
       }
   }
   

   然后，在你的 Filter 或 Servlet 中使用这个包装类：

   public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
           throws IOException, ServletException {
       CachedBodyHttpServletRequestWrapper wrappedRequest = new CachedBodyHttpServletRequestWrapper((HttpServletRequest) request);
       chain.doFilter(wrappedRequest, response);
   }
   

2. 使用 ContentCachingRequestWrapper（Spring框架中）：
   如果你使用的是 Spring 框架，可以使用 ContentCachingRequestWrapper 来缓存请求体。它是 Spring 提供的一个类，可以在不改变代码结构的情况下实现请求体的多次读取。

   示例代码：

   @Component
   public class RequestLoggingFilter extends OncePerRequestFilter {
   
       @Override
       protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
               throws ServletException, IOException {
   
           ContentCachingRequestWrapper wrappedRequest = new ContentCachingRequestWrapper(request);
   
           filterChain.doFilter(wrappedRequest, response);
   
           byte[] requestBody = wrappedRequest.getContentAsByteArray();
           String body = new String(requestBody, wrappedRequest.getCharacterEncoding());
           // 可以在这里处理请求体
       }
   }
   

3. BufferedInputStream：
   你也可以在原始输入流基础上使用 BufferedInputStream 缓存数据。这样可以在第一次读取后将数据存入内存，在后续需要时可以再次访问。此方法较为简便，但不如 HttpServletRequestWrapper 方式灵活。

总结：

HttpServletRequest 的输入流只能读取一次的原因主要与流的单向性和性能考虑有关。使用 HttpServletRequestWrapper 或类似的封装类缓存数据，是解决这个问题的有效方案。