Java中如何将multipart/form-data请求体的字节数组转为字符串？

图片损坏的核心原因 #

你当前的处理逻辑是把整个二进制的multipart请求体当成纯字符串来切割、修改，哪怕用了ISO_8859_1编码，也会踩两个致命坑：

• 二进制内容误分割：图片等文件的字节流里，完全可能出现和boundary（比如--xxxx）一模一样的字节组合，按字符串分割时会错误切开文件内容，直接破坏文件结构。
• 格式规范被破坏：multipart协议要求分隔用\r\n，转成字符串再转回字节的过程中，部分场景下换行符会被改成\n，导致后端解析时无法正确识别文件边界，最终文件损坏。

ISO_8859_1本身是单字节一一映射的编码，转成String再转回byte[]不会改变字节，问题出在基于字符串的分割组装操作，不是编码选得不对。

正确处理方式（Spring WebFlux环境） #

别手动转字符串折腾，用Spring自带的multipart解析工具来处理，分三步：

1. 解析原始请求体为Multipart部件 #

把传入的byte[]包装成DataBuffer，用MultipartHttpMessageReader解析成各个Part：

// 包装原始字节数组为DataBuffer
DataBuffer dataBuffer = DefaultDataBufferFactory.sharedInstance.wrap(body);
// 构建模拟请求用于解析
MockServerHttpRequest request = MockServerHttpRequest.post("/")
        .contentType(MediaType.MULTIPART_FORM_DATA)
        .body(dataBuffer);

// 初始化解析器并解析
MultipartHttpMessageReader reader = new MultipartHttpMessageReader();
Flux<Part> parts = reader.readMono(Part.class, request, Collections.emptyMap())
        .flatMapMany(Flux::fromIterable);

2. 修改指定文本部件 #

遍历解析后的Part，只修改需要调整的文本部分，二进制部件直接保留：

Flux<Part> modifiedParts = parts.map(part -> {
    if ("text1".equals(part.name())) {
        // 替换文本部件的内容
        return FormFieldPart.create("text1", "修改后的文本值");
    }
    // 图片等二进制部件直接返回原对象
    return part;
});

3. 重新组装成multipart请求体 #

用MultipartBodyBuilder把修改后的部件重新拼成完整的请求体字节数组：

MultipartBodyBuilder builder = new MultipartBodyBuilder();
// 遍历修改后的部件加入构建器
modifiedParts.subscribe(part -> {
    if (part instanceof FilePart filePart) {
        builder.part(part.name(), filePart.content(), filePart.headers());
    } else if (part instanceof FormFieldPart fieldPart) {
        builder.part(part.name(), fieldPart.value());
    }
});

// 生成最终的字节数组
Mono<byte[]> newBodyMono = Mono.defer(() -> {
    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.MULTIPART_FORM_DATA);
    return new MultipartHttpMessageWriter().write(Mono.just(builder.build()), headers,
            new DefaultServerHttpResponse(new MockServerHttpResponse()), Collections.emptyMap())
            .flatMap(response -> DataBufferUtils.join(response.getBody())
                    .map(buffer -> {
                        byte[] bytes = new byte[buffer.readableByteCount()];
                        buffer.read(bytes);
                        DataBufferUtils.release(buffer);
                        return bytes;
                    }));
});

另一种简化思路 #

如果不想用Spring的解析工具，也可以：

• 拆分multipart时用字节数组匹配boundary，而非字符串分割，避免二进制内容被误切
• 只把文本部件的内容转成字符串修改，二进制部件直接保留原始字节，最后再按multipart格式拼接回去

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