Java如何创建multipart/mixed请求并替换流占位符解决文件损坏问题

核心错误点 #

• 强制将二进制Excel字节转为UTF-8字符串是根本问题：XLSX属于二进制格式，所有字节序列都是合法的文件内容，但UTF-8编码有严格的格式规则，不合法的字节序列会被自动替换为�（U+FFFD替换字符），直接篡改了原始文件的字节结构，导致下载后的文件校验不通过、损坏无法打开。
• 处理multipart请求体的逻辑错误：multipart/form-data格式本身就是混合文本字段和二进制字段的结构，不能将整个请求体当做纯字符串处理后做占位符替换，二进制字段的内容必须保持原始字节形式拼接。
• 违背了Content-Transfer-Encoding的声明：你在请求模板里声明inputFile部分的传输编码是binary，意味着这部分需要传输原始二进制字节，转成UTF-8字符串的操作完全不符合该声明的要求。

修复方案 #

• 放弃将整个请求模板当做字符串处理的思路，拆分模板为两部分：{{stream}}之前的内容转为固定字节数组，{{stream}}之后的边界收尾内容转为固定字节数组，构造请求体时直接按「前缀字节 + Excel原始字节（就是ByteArrayOutputStream直接toByteArray的结果，不要转字符串） + 后缀字节」的顺序拼接即可。
• 更稳妥的方案是直接使用成熟HTTP客户端的multipart构造能力，比如OkHttp的MultipartBody、Apache HttpClient的MultipartEntityBuilder、Spring WebClient的BodyInserters.fromMultipartData，不需要手动处理边界、编码规则，能完全避免这类低级错误。

内容的提问来源于stack exchange，提问作者Sooriya