Failed to parse multipart servlet request; nested exception is java.lang.IllegalStateException: getReader() has already been called for this request

### 问题分析与解决方案 在处理 multipart servlet 请求时，`java.lang.IllegalStateException: getReader() has already been called for this request` 异常通常表明请求的输入流已经被消耗了一次，而无法再次读取。这种问题可能由以下几种情况引起： 1. **请求头中设置了不匹配的 `Content-Type`**：如果请求头中的 `Content-Type` 被显式设置为非 multipart 类型（例如 `application/json`），框架可能会尝试使用 `getReader()` 方法读取请求体，从而导致后续的 multipart 解析失败[^1]。 2. **多次读取请求体**：在某些场景下，开发人员可能需要多次读取请求体（例如签名验证或日志记录）。然而，`HttpServletRequest` 的输入流只能被读取一次。如果已经调用了 `getReader()` 或 `getInputStream()`，则会抛出上述异常[^2]。 3. **框架内部行为**：某些 Spring 过滤器（如 `HiddenHttpMethodFilter`）可能会提前读取请求体以实现特定功能（例如方法重写），从而影响后续的 multipart 解析[^3]。 #### 解决方案 以下是几种可行的解决方案： ### 1. 确保 `Content-Type` 正确 检查客户端发送的请求头，确保 `Content-Type` 设置为 `multipart/form-data`。如果使用工具（如 Postman）进行测试，避免手动设置错误的 `Content-Type`。例如，在 Postman 中选择正确的请求类型即可自动配置正确的头部信息[^1]。 ```python # 示例代码：确保 Content-Type 正确 import requests url = "http://example.com/upload" files = {'file': open('example.txt', 'rb')} response = requests.post(url, files=files) ``` ### 2. 使用自定义过滤器解决多次读取问题 如果需要多次读取请求体，可以创建一个包装类来缓存请求内容。以下是一个示例实现： ```java import javax.servlet.ReadListener; import javax.servlet.ServletInputStream; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequestWrapper; import java.io.*; public class MultiReadRequestWrapper extends HttpServletRequestWrapper { private final byte[] body; public MultiReadRequestWrapper(HttpServletRequest request) throws IOException { super(request); body = IOUtils.toByteArray(request.getInputStream()); } @Override public ServletInputStream getInputStream() throws IOException { return new ServletInputStream() { private ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(body); @Override public boolean isFinished() { return byteArrayInputStream.available() == 0; } @Override public boolean isReady() { return true; } @Override public void setReadListener(ReadListener readListener) { throw new UnsupportedOperationException(); } @Override public int read() throws IOException { return byteArrayInputStream.read(); } }; } @Override public BufferedReader getReader() throws IOException { return new BufferedReader(new InputStreamReader(getInputStream())); } } ``` 在过滤器中使用该包装类： ```java @Override protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { HttpServletRequest wrappedRequest = new MultiReadRequestWrapper(request); filterChain.doFilter(wrappedRequest, response); } ``` 此方法允许多次读取请求体，从而避免 `IllegalStateException` 异常[^2]。 ### 3. 禁用相关过滤器 如果确认不需要某些 Spring 过滤器的功能（例如 `HiddenHttpMethodFilter`），可以通过配置禁用它们： ```yaml spring: mvc: hiddenmethod: filter: enabled: false ``` 禁用后，框架将不再提前读取请求体，从而避免冲突[^3]。 --- ### 总结 通过确保 `Content-Type` 正确、使用自定义请求包装类或禁用不必要的过滤器，可以有效解决 `java.lang.IllegalStateException: getReader() has already been called for this request` 异常问题。