Spring Boot Jersey Multipart上传报错：Missing start boundary问题

我之前在做Spring Boot集成Jersey 2.26实现文件上传时，也踩过这个「Missing start boundary」的坑，大概率是Multipart的配置没做全，给你整理了一套解决步骤：

1. 确认依赖版本对齐 #

你已经引入了jersey-media-multipart，不过要注意让它的版本和Spring Boot Starter Jersey的版本保持一致——Spring Boot 2.0.x默认集成的就是Jersey 2.26，所以不用手动指定版本，让Spring Boot的依赖管理自动处理就行，依赖配置可以保持这样：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jersey</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-multipart</artifactId>
</dependency>

2. 必须注册MultipartFeature到Jersey配置 #

这是最容易忽略也是最关键的一步！我当时就是漏了这个配置，折腾了好半天。你需要在自己的Jersey配置类（继承ResourceConfig的那个）里显式注册MultipartFeature，不然Jersey根本不知道怎么解析多部件请求：

import org.glassfish.jersey.media.multipart.MultipartFeature;
import org.springframework.stereotype.Component;
import javax.ws.rs.ApplicationPath;
import org.glassfish.jersey.server.ResourceConfig;

@Component
@ApplicationPath("/api")
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        // 先注册你的文件上传资源类
        register(FileUploadResource.class);
        // 一定要加这行！注册Multipart解析特性
        register(MultipartFeature.class);
    }
}

3. 检查上传接口的注解写法 #

确保你的接口方法正确使用了Jersey的Multipart相关注解，比如用@Consumes(MediaType.MULTIPART_FORM_DATA)指定请求类型，用@FormDataParam获取文件参数：

import javax.ws.rs.Consumes;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.core.MediaType;
import org.glassfish.jersey.media.multipart.FormDataParam;
import java.io.InputStream;

@Path("/files")
public class FileUploadResource {

    @POST
    @Path("/upload")
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    public String handleFileUpload(
            @FormDataParam("file") InputStream fileStream,
            @FormDataParam("file") org.glassfish.jersey.media.multipart.FormDataContentDisposition fileMeta) {
        // 这里写你的文件处理逻辑，比如保存到本地或者OSS
        String fileName = fileMeta.getFileName();
        return String.format("文件 %s 上传成功", fileName);
    }
}

4. 排查请求端的格式问题 #

如果上面的配置都没问题，那就要看请求本身是否符合规范：

• 发送请求时，Content-Type必须是multipart/form-data，并且要自动生成（或正确携带）boundary参数，比如multipart/form-data; boundary=----WebKitFormBoundaryxxx
• 用Postman测试的话，直接选择form-data类型就行，它会自动帮你生成boundary，不要手动修改Content-Type字段，很容易写错

错误原因解析 #

「Missing start boundary」说白了就是Jersey的Multipart解析器找不到请求中约定的分隔边界，常见的触发场景：

• 没注册MultipartFeature，Jersey无法识别multipart请求格式
• 请求的Content-Type没有带boundary，或者boundary格式错误
• 手动构造请求时，boundary和请求体里的分隔符不匹配

按照上面的步骤一步步排查，应该就能解决这个问题了！

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