使用Jersey Client上传文件至云端遇400错误求技术排查

你在使用Jersey Client上传文件时碰到了400请求错误，我帮你梳理下代码里的几个关键问题：

核心问题分析 #

• 表单字段构造逻辑错误：你把完整的JSON字符串当作了表单字段名，但服务端应该期望的是name和parent这两个独立的表单字段，而非将JSON串作为字段名传入。
• Content-Disposition设置冗余且错误：你给整个FormDataMultiPart设置了文件的Content-Disposition，这会破坏多部分表单的正确结构；实际上FileDataBodyPart会自动处理文件对应的Content-Disposition信息。
• 手动设置Content-Type引发冲突：手动指定Content-Type: multipart/form-data会丢失Jersey自动生成的boundary分隔符，导致服务端无法正确解析多部分表单内容。

修正后的代码 #

final Client client = ClientBuilder.newBuilder().register(MultiPartFeature.class).build();

// 构造表单的普通字段（name和parent）
FormDataMultiPart formDataMultiPart = new FormDataMultiPart();
formDataMultiPart.field("name", fileName);
formDataMultiPart.field("parent", "0"); // 若服务端期望数字类型，可改为Integer.valueOf(0)

// 添加文件部分
FileDataBodyPart filePart = new FileDataBodyPart("file", new File(fileLocation));
formDataMultiPart.bodyPart(filePart);

// 构建请求目标
final WebTarget target = client.target("http://test.net/hello");

// 发送请求：无需手动设置Content-Type，由Entity自动生成带boundary的正确头信息
final Response response = target.request()
        .header("instanceid", "b05642c8-d231-48fe-a163-d978a6208d98")
        .post(Entity.entity(formDataMultiPart, MediaType.MULTIPART_FORM_DATA));

// 关闭资源避免泄漏
formDataMultiPart.close();

关键修改说明 #

1. 正确构造表单字段：直接用field()方法分别添加name和parent字段，完全匹配服务端对表单数据的预期，无需将字段打包成JSON串。
2. 移除错误的全局Content-Disposition设置：删除multiPart.setContentDisposition(...)，FileDataBodyPart会自动为文件部分生成包含文件名的正确Content-Disposition。
3. 删除手动Content-Type头：Entity.entity(formDataMultiPart, MediaType.MULTIPART_FORM_DATA)会自动生成带boundary的完整Content-Type（比如multipart/form-data; boundary=xxxx），服务端依赖这个boundary拆分多部分内容。
4. 添加资源关闭操作：FormDataMultiPart实现了AutoCloseable接口，使用后关闭可避免资源泄漏。

如果修改后仍有问题，建议开启Jersey的日志功能，打印出实际发送的请求内容，对比服务端API文档确认格式是否完全匹配。

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