如何正确设置java.net.http.HttpRequest的Boundary解决文件上传报错

你的问题根源很明确：服务器找不到multipart请求的边界，是因为你既没有按正确格式设置Content-Type头，也没有构造符合multipart规范的请求体。

先拆解你原代码的核心问题：

1. 你单独设置了Boundary头，但HTTP标准里，服务器只会从Content-Type头中读取边界参数，这个单独的头服务器完全不识别。
2. 你直接用HttpRequest.BodyPublishers.ofFile(filePath)把文件内容作为整个请求体，没有按照multipart/form-data的格式添加边界分隔符、表单字段描述等关键结构，服务器根本没法解析这个请求。

下面是修正后的完整代码，完全基于JDK 11原生HttpClient实现：

import java.io.IOException;
import java.net.URI;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class MultipartFileSender {

    public static int sendMultipartFile(String uri, Path filePath) throws IOException, InterruptedException {
        HttpClient httpClient = HttpClient.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .connectTimeout(java.time.Duration.ofSeconds(10))
                .build();

        String boundary = "gc0p4Jq0M2Yt08jU534c0p";
        String fileName = filePath.getFileName().toString();

        // 构建multipart请求的起始部分：边界 + 表单字段描述
        String startPart = "--" + boundary + "\r\n"
                + "Content-Disposition: form-data; name=\"logs.7z\"; filename=\"" + fileName + "\"\r\n"
                + "Content-Type: application/x-7z-compressed\r\n\r\n";
        byte[] startPartBytes = startPart.getBytes(StandardCharsets.UTF_8);

        // 文件内容的流式发布器
        HttpRequest.BodyPublisher filePart = HttpRequest.BodyPublishers.ofFile(filePath);

        // 构建multipart请求的结束部分：闭合边界
        String endPart = "\r\n--" + boundary + "--\r\n";
        byte[] endPartBytes = endPart.getBytes(StandardCharsets.UTF_8);

        // 组合所有部分为完整的multipart请求体
        HttpRequest.BodyPublisher multipartBody = HttpRequest.BodyPublishers.concat(
                HttpRequest.BodyPublishers.ofByteArray(startPartBytes),
                filePart,
                HttpRequest.BodyPublishers.ofByteArray(endPartBytes)
        );

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(uri))
                .POST(multipartBody)
                // 正确的Content-Type格式：必须包含boundary参数
                .header("Content-Type", "multipart/form-data; boundary=" + boundary)
                .build();

        HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
        return response.statusCode();
    }
}

关键注意点： #

• Content-Type头的标准格式：必须写成multipart/form-data; boundary=你的边界字符串，这是HTTP协议规定的格式，服务器会从这里提取边界值来分割请求体中的各个部分。
• 请求体的multipart结构：完整的multipart请求体必须包含：
  • 起始边界（--边界值）
  • 表单字段的Content-Disposition：其中name必须和服务器端@RequestParam("logs.7z")的参数名完全一致，filename是上传文件的名称
  • 文件对应的Content-Type：7z文件用application/x-7z-compressed，其他文件请对应调整（比如zip用application/zip，文本文件用text/plain）
  • 闭合边界（--边界值--）
• 这种实现方式支持大文件上传，因为BodyPublishers.concat会流式处理各个部分，不会把整个文件加载到内存中。

如果你觉得手动拼接multipart格式太繁琐，也可以考虑使用Apache HttpClient或OkHttp这类第三方库，它们都有封装好的Multipart请求构建器，但如果想纯用JDK原生实现，上面的代码就能完美解决你的问题。

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