MalformedStreamException 异常与 multipart/form-data 边界机制
org.apache.tomcat.util.http.fileupload.MultipartStream$MalformedStreamException 是 Tomcat 在处理文件上传时抛出的一个异常，通常表示接收到的文件数据格式不符合规范，导致无法正确解析。
一、错误原因分析
1. 数据截断
上传过程中网络中断、用户取消或服务器超时可能导致文件未完整传输。Tomcat 在读取流时未能找到预期的结束分隔符，从而抛出异常。
2. 格式错误
HTTP 文件上传需遵循 multipart/form-data 协议。如果请求头缺少 Content-Type: multipart/form-data 或分隔符（boundary）定义不正确，服务器无法拆解数据。
3. 换行符不规范
RFC 2046 规范要求 multipart/form-data 的边界前后必须使用 CRLF (\r\n) 作为换行符。若仅使用 LF (\n)，解析器可能无法识别边界。
4. 正则匹配问题
在手动处理边界字符串时，正则表达式若未正确提取 boundary 值（例如包含了前导短横线），会导致后续解析失败。
二、multipart/form-data 边界机制
1. 边界的作用
边界（boundary）是用于分隔表单中多个不同部分（如文本字段、文件上传）的特殊字符串。它确保接收方能准确识别每个部分的起始和结束位置。
2. 边界规范
- 格式：以两个短横线
--开头，后跟唯一字符串。 - 声明：在
Content-Type头中指定，例如：
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryABC123
- 换行符：边界前后必须使用
\r\n。 - 结束标记：最后一个边界需以
--结尾（如--boundary--）。
3. WebKitFormBoundary 与纯数字边界
- WebKitFormBoundary：浏览器（Chrome/Safari）自动生成，通常带有
WebKitFormBoundary前缀，便于调试。 - 纯数字边界：手动构造或使用工具生成，通常为随机数字组合（如
---------------------------149742642616556）。 - 等价性：两者功能完全等价，只要符合
--<唯一字符串>格式且与 Content-Type 声明一致即可。
三、解决方案
1. 检查客户端代码
确保表单包含 enctype="multipart/form-data"，API 调用时设置正确的 Content-Type 请求头。
HTML 示例：
<form action="/upload" method="post" enctype="multipart/form-data">
<input type="file" name="file">
<button type="submit">上传</button>
</form>
2. 修正换行符与正则
确保所有换行符为 CRLF (\r\n)。若需手动提取 boundary，修正正则表达式以排除前导 --。
Java 修复示例：
String regexp = "(?m)\\A--(-*\\d+)$";
Pattern pattern = Pattern.compile(regexp);
Matcher matcher = pattern.matcher(byteString);
String boundary = null;
while (matcher.find()) {
boundary = matcher.group(1); // 获取捕获组内容
}
3. 服务器配置
设置合理的上传大小限制，避免大文件被中途拦截。
Java Servlet 示例：
DiskFileItemFactory factory = new DiskFileItemFactory();
ServletFileUpload upload = new ServletFileUpload(factory);
upload.setSizeMax(10 * 1024 * 1024); // 限制 10MB
4. 调试与日志
- 启用 Tomcat 详细日志：
logging.level.org.apache.tomcat.util.http.fileupload=DEBUG
- 使用 Postman 或 curl 发送最小测试请求，排除代理或负载均衡干扰。
四、总结
该错误的核心在于 Tomcat 收到的文件上传数据不符合 multipart/form-data 规范。解决方法包括：
- 确保客户端发送正确的数据格式（表单、API）。
- 确保服务器能正确接收（代码逻辑、配置、日志）。
- 严格遵循 RFC 2046 规范，统一使用 CRLF 换行符并正确声明边界。
理解边界的规范和常见陷阱，能有效避免文件上传时的解析错误。
