它触及了 Java Web容器（Servlet规范） 处理 HTTP请求体（Request Body） 的核心机制，以及 输入/输出流（IO Stream） 的基本特性。
🧐 为什么 HttpServletRequest 的 Body 只能被读取一次？
核心原因在于 HTTP 协议和 Java I/O 流的本质，尤其是对于 流式数据 (Streamed Data) 的处理。
1. HTTP 请求体的本质是“输入流” (Input Stream)
在 Java Web 应用中，当服务器接收到一个 HTTP 请求时，请求的 Header（如方法、路径、Content-Type）会被解析成字符串/集合等对象，但请求的 Body（如 POST/PUT 请求中的 JSON、XML、文件内容）通常是一个 字节序列。
Web 容器（如 Tomcat）不会一次性将整个 Body 加载到内存中，而是将其暴露为一个 ServletInputStream（通过 request.getInputStream() 获取）。
-
流（Stream） 的概念就像水管里的水流：数据是按顺序从源头（客户端）流向目的地（服务器）的。
-
读取（Read） 意味着水被抽走了。一旦一个字节的数据被读取并处理，它就从流中消耗掉了，无法回溯。
-
这种设计是出于对 性能和内存 的优化，特别是处理 大文件上传 或 超大请求体 时。如果每次请求都必须把整个 Body 缓存起来，服务器很快就会耗尽内存（OOM）。
2. 对比 List 或 Map 等集合
您提到 List 和 Map 可以多次读取，这是因为它们是 内存中的数据结构 (In-Memory Data Structures)。
特性
集合 (List, Map)
输入流 (ServletInputStream)
存储位置
内存 (RAM)
通常是网络套接字 (Socket) 或磁盘文件（临时缓存）
数据特性
静态 (Static)，数据被完全加载到内存中。
动态/流式 (Streaming)，数据按需从网络读取。
读取机制
基于索引或键的查找，非破坏性 读取。
破坏性 读取，读取后数据从缓冲区或网络中消耗。
可重复性
可重复，因为它有副本在内存中。
不可重复，因为原始数据源（网络连接）通常无法重放。
3. 如何解决“需要多次读取”的问题？
如果您的应用程序确实需要在不同地方多次访问请求体的内容（例如，一个过滤器/拦截器需要读取进行日志记录，然后控制器也需要读取进行业务处理），您可以采用以下两种标准方法：
方法一：在第一次读取时手动缓存 (最常用)
您可以在第一个需要读取请求体的组件（通常是 Filter 或 Interceptor）中，将整个流读取完毕，并将其内容（通常是字节数组 byte[] 或字符串 String）存储在一个变量中。
-
Filter/Interceptor 负责读取并缓存 Body：
Java
byte[] bodyBytes = request.getInputStream().readAllBytes(); // 缓存到 request 的属性中或自定义的包装类中 request.setAttribute("cachedBody", bodyBytes); -
后续组件 从缓存中获取数据，而不是重新读取流。
方法二：使用 HttpServletRequestWrapper
这是解决这个问题的标准、优雅的方法。您需要创建一个自定义的 HttpServletRequestWrapper，重写它的 getInputStream() 和 getReader() 方法，使其返回一个基于您缓存的字节数组的 新流 (ByteArrayInputStream)。
这样，您就可以在不破坏 Servlet 规范 API 的情况下，实现请求体的多次读取。这在 Spring Security 或日志框架中非常常见。
总结：
请求体流的“只能读一次”是 高性能流式处理 的一个基本特性，它保护了服务器在处理大量数据时不会因为内存耗尽而崩溃。如果您需要多次访问，您必须在应用层面上显式地进行缓存。