如何在Java的POST请求中设置自定义Content-Disposition请求头？

你的核心问题是：将Content-Disposition头直接添加到了整个HttpPost请求上，但C#代码中是给单个文件上传的Part添加额外参数。Apache HttpClient的MultipartEntityBuilder会自动为每个Part生成Content-Disposition头，覆盖你设置在请求上的全局头，导致自定义参数丢失。

以下是正确的实现代码，完全复现C#版本的请求效果：

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.mime.FormBodyPart;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import java.io.File;
import java.io.IOException;

public class MultipartFileUpload {
    public static void main(String[] args) throws IOException {
        File file = new File("filepath");
        String jwtToken = "your-jwt-token";
        String targetUrl = "your-server-url";

        // 初始化文件体
        FileBody fileBody = new FileBody(file, ContentType.DEFAULT_BINARY);

        // 构建包含自定义参数的Content-Disposition
        org.apache.http.entity.ContentDisposition disposition = org.apache.http.entity.ContentDisposition
                .builder("form-data")
                .name("file")
                .filename("file.zip.encrypted")
                .parameter("Type", "CSV")
                .parameter("Token", jwtToken)
                .build();

        // 创建自定义Part，绑定文件体和自定义头
        FormBodyPart filePart = new FormBodyPart("file", fileBody);
        filePart.setHeader("Content-Disposition", disposition.toString());

        // 组装Multipart实体
        HttpEntity multipartEntity = MultipartEntityBuilder.create()
                .addPart(filePart)
                .build();

        // 执行请求
        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpPost postRequest = new HttpPost(targetUrl);
            postRequest.setEntity(multipartEntity);

            try (HttpResponse response = client.execute(postRequest)) {
                System.out.println("响应状态: " + response.getStatusLine());
                String responseContent = EntityUtils.toString(response.getEntity());
                System.out.println("响应内容: " + responseContent);
            }
        }
    }
}

关键说明： #

1. 针对单个Part设置头：通过FormBodyPart为文件上传的单独Part设置自定义Content-Disposition，而非全局请求头
2. 使用官方API构建头：利用Apache HttpClient提供的ContentDisposition.builder()方法，规范生成包含自定义参数的头内容，避免手动拼接字符串的格式错误
3. 依赖要求：确保项目中引入了httpmime依赖（与Apache HttpClient版本匹配）

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