本文详解在 java web 开发中，如何可靠、同步地读取 http 请求体（request body）的原始字节并转换为字符串，避免因流阻塞、缓冲区误判或提前终止导致的“仅在取消请求时才读到数据”的典型问题。
本文详解在 java web 开发中，如何可靠、同步地读取 http 请求体（request body）的原始字节并转换为字符串，避免因流阻塞、缓冲区误判或提前终止导致的“仅在取消请求时才读到数据”的典型问题。
在处理 HTTP POST 请求时，若需手动解析请求体（例如对接非标准格式、绕过框架自动绑定、或实现自定义协议解析），开发者常会直接操作 HttpServletRequest.getInputStream()。但一个常见陷阱是：误用基于行（readLine()）的读取逻辑来处理二进制或无换行结构的请求体——这正是原问题的根本原因。
原代码中 readBody(int length) 方法循环调用 readLine()，期望通过匹配行长度来截断读取。然而：
- readLine() 以 \n、\r\n 或 \r 为分隔符，不适用于无换行的 JSON、表单 URL 编码（含空格/+/=）或二进制载荷；
- 若请求体末尾无换行符，readLine() 将阻塞等待（表现为“必须取消页面加载才能继续”）；
- 即使有换行，按“行长度等于目标长度”判断也极易误判（如多行数据、编码后长度变化等）。
✅ 正确做法是：按指定字节数精确读取，再解码为字符串。以下是推荐实现：
private String readBody(int expectedLength) throws IOException {
debug("STARTING BODY READ (expected " + expectedLength + " bytes)");
if (expectedLength <= 0) {
debug("Empty body, returning empty string");
return "";
}
InputStream in = request.getInputStream();
byte[] bodyBytes = new byte[expectedLength];
int totalRead = 0;
int bytesRead;
// 循环确保读满 expectedLength 字节（处理网络分片）
while (totalRead < expectedLength) {
bytesRead = in.read(bodyBytes, totalRead, expectedLength - totalRead);
if (bytesRead == -1) {
throw new IOException("Unexpected end of stream: only " + totalRead + "/" + expectedLength + " bytes read");
}
totalRead += bytesRead;
}
// 使用 UTF-8 解码（根据实际 Content-Type 调整，如 application/json 默认 UTF-8）
String body = new String(bodyBytes, StandardCharsets.UTF_8);
debug("BODY READ SUCCESSFULLY: " + body);
return body;
}⚠️ 关键注意事项：
- 勿重复读取：getInputStream() 和 getReader() 互斥，调用任一方法后不可再调用另一个，否则抛 IllegalStateException；
- Content-Length 是关键依据：务必通过 request.getContentLength() 或 request.getHeader("Content-Length") 获取准确长度（注意：对 chunked transfer encoding 需用 getInputStream() 按块读取，本例假设已知长度）；
- 字符集需显式指定：new String(byte[], charset) 比 String.valueOf(char[]) 更安全——后者依赖平台默认编码，易引发乱码；UTF-8 是现代 Web 的事实标准；
- 异常处理不可省略：网络流可能中断，需捕获 IOException 并合理响应（如返回 400 Bad Request）；
- 性能提示：对超大请求体，应限制最大长度（如 if (length > 10 * 1024 * 1024) throw new IllegalArgumentException("Body too large")），防止内存溢出。
总结：读取请求体的本质是面向字节的确定性读取，而非面向文本的启发式解析。抛弃 readLine()，拥抱 InputStream.read(byte[], offset, length)，并严格依据 Content-Length 和明确字符集进行解码，即可彻底解决“必须取消请求才能读取”的问题，实现稳定、可预测的请求体解析。
