Spring Boot整合Jersey处理Multipart文件配置异常排查

我之前也踩过一模一样的坑，Spring Boot 1.5.x和Jersey的Multipart处理确实存在不少配置冲突的问题，结合你的场景，给你几个针对性的解决方案：

1. 确保Jersey的MultiPartFeature正确注册且依赖版本匹配 #

首先，jersey-media-multipart的版本必须和Spring Boot自带的Jersey版本对齐（Spring Boot 1.5.13对应的Jersey版本是2.25.1），版本不兼容会直接导致配置失效。

在pom.xml中确认依赖（无需手动指定版本，Spring Boot父工程会自动管理）：

<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-multipart</artifactId>
</dependency>

然后在你的JerseyConfig中优先注册MultiPartFeature，保证它的加载顺序在资源类之前：

@Configuration
public class JerseyConfig extends ResourceConfig {
    public JerseyConfig() {
        // 先注册Multipart核心处理类
        register(MultiPartFeature.class);
        // 再注册你的资源类
        register(AttachmentResource.class);
        // 其他资源/过滤器注册...
    }
}

2. 禁用Spring Boot的Multipart自动配置 #

Spring Boot的MultipartAutoConfiguration会自动生成一套自己的Multipart解析器，这会和Jersey的处理机制直接冲突，导致getParts()找不到正确的配置。

在启动类上排除这个自动配置类：

@SpringBootApplication(exclude = MultipartAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

或者直接在application.properties中禁用：

spring.http.multipart.enabled=false

3. 移除自定义的CommonsMultipartResolver #

你自定义的CommonsMultipartResolver是Spring体系的Multipart解析器，和Jersey的MultiPartFeature是两套完全独立的机制，同时存在会导致请求解析逻辑混乱，直接删除这个Bean即可。

4. 优先使用Jersey原生的Multipart处理方式 #

其实Jersey推荐用自身的注解来处理文件上传，而不是直接调用HttpServletRequest.getParts()，这样能从根源避免和Spring的配置冲突。比如把你的AttachmentResource改成这样：

@Path("/attachments")
public class AttachmentResource {

    @POST
    @Path("/upload")
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    public Response uploadFile(
            @FormDataParam("file") InputStream fileInputStream,
            @FormDataParam("file") FormDataContentDisposition fileMeta) {
        
        // 这里处理文件逻辑，比如获取文件名：fileMeta.getFileName()
        return Response.status(Response.Status.OK)
                .entity("文件 " + fileMeta.getFileName() + " 上传成功")
                .build();
    }
}

5. 验证请求的Content-Type正确性 #

最后要确保前端发送请求时，Content-Type严格设置为multipart/form-data且包含boundary参数，比如：

Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

如果Content-Type格式不正确，服务器也会抛出“无Multipart配置”的异常。

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

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