Jersey REST服务多文件上传：CURL调用FormDataMultiPart为空排查

我来帮你排查下问题所在，你遇到的multiPart为null的情况，主要是几个容易忽略的细节没处理好，咱们一步步来修正：

1. 核心错误：参数注入方式不对 #

你在方法参数上用@FormDataParam("file")修饰FormDataMultiPart是错误的。FormDataMultiPart本身代表整个multipart请求体，不需要通过字段注解来指定，直接作为方法参数即可。

修正后的服务端代码：

@POST
@Path("/sample-bulk")
@Consumes(MediaType.MULTIPART_FORM_DATA)
public Response bulkUpload(FormDataMultiPart multiPart) {
    // 打印所有名为"file"的上传文件
    log.info("Received file parts: {}", multiPart.getFields("file"));
    return Response.ok().build();
}

2. 必须注册MultiPartFeature #

Jersey默认不支持multipart请求处理，你需要显式注册MultiPartFeature，同时确保依赖包已正确引入：

Maven依赖（确保版本和Jersey核心一致） #

<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-multipart</artifactId>
    <version>你的Jersey版本号</version>
</dependency>

在Jersey配置类中注册Feature #

public class YourJerseyConfig extends ResourceConfig {
    public YourJerseyConfig() {
        // 注册multipart处理特性
        register(MultiPartFeature.class);
        // 注册你的资源类
        register(YourUploadResource.class);
    }
}

这一步是很多人会遗漏的，没注册的话Jersey根本不知道怎么解析multipart请求，自然会返回null。

3. 修正CURL命令的小问题 #

你的原命令里URL前后有多余空格，可能导致请求路径错误，而且如果要上传多文件，需要重复-F参数：

多文件上传的正确CURL命令：

curl -X POST "http://localhost:37200/api/sample-bulk" \
     -H "accept: application/json" \
     -F "file=@/Users/naman/Desktop/Media/video.mp4;type=video/mp4" \
     -F "file=@/Users/naman/Desktop/Media/another-file.png;type=image/png"

4. 额外调试建议 #

• 先测试单文件上传，确认服务端能正常接收参数后，再扩展到多文件；
• 可以在服务端打印请求头，确认Content-Type确实是multipart/form-data; boundary=xxx格式（curl会自动生成boundary，不用手动指定）；
• 如果还是有问题，检查项目中是否有其他过滤器/interceptor干扰了请求体的解析。

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