如何正确消费multipart/mixed负载？遇415 UnsupportedMediaType错误

嘿，我懂你现在的头疼点——用String参数能拿到请求内容，但换成专门的Multipart类型就报415，这确实挺闹心的。让我一步步帮你搞定这个问题：

问题根源 #

从你用的@Path、@Consumes这些注解能看出来，你用的是JAX-RS框架。默认情况下它并没有内置multipart/mixed类型的消息体解析器：

• 用String当参数时，框架只是把整个请求体当成纯文本粗暴读了出来，属于“凑合用”的临时方案；
• 但当你尝试用Multipart、RequestPart这类专门的类型时，框架找不到对应的解析器，直接就抛出415异常了。

解决方案步骤 #

1. 引入Multipart解析依赖

假设你用的是Jersey（最常用的JAX-RS实现），先在项目里添加multipart媒体支持的依赖：
如果是Maven项目，在pom.xml里加：

<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-multipart</artifactId>
    <version>和你的Jersey核心版本保持一致</version>
</dependency>

如果是Gradle项目，对应配置：

implementation 'org.glassfish.jersey.media:jersey-media-multipart:你的Jersey版本号'

2. 注册MultipartFeature

在你的JAX-RS应用配置类里，注册MultiPartFeature，让框架启用multipart类型的解析功能：

import org.glassfish.jersey.media.multipart.MultiPartFeature;
import javax.ws.rs.core.Application;
import java.util.HashSet;
import java.util.Set;

public class YourAppConfig extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> resources = new HashSet<>();
        // 注册Multipart解析器
        resources.add(MultiPartFeature.class);
        // 别忘了注册你的API资源类
        resources.add(YourUserApiResource.class);
        return resources;
    }
}

3. 修改API方法参数

现在你可以用FormDataMultiPart（或者MultiPart）来接收请求，就能正确解析每个multipart部分了：

import org.glassfish.jersey.media.multipart.FormDataMultiPart;
import org.glassfish.jersey.media.multipart.FormDataBodyPart;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.Consumes;
import javax.ws.rs.core.MediaType;

@POST
@Path("/jsonform")
@Consumes(MediaType.MULTIPART_MIXED)
public void simpler(FormDataMultiPart multiPart) {
    // 遍历每个multipart分片
    for (FormDataBodyPart part : multiPart.getBodyParts()) {
        String contentId = part.getContentId();
        MediaType contentType = part.getMediaType();
        // 读取分片内容，也可以根据需要转成JSON对象
        String content = part.getValueAsString();
        
        System.out.println("===== 分片信息 =====");
        System.out.println("Content-ID: " + contentId);
        System.out.println("Content-Type: " + contentType);
        System.out.println("Content: " + content);
    }
}

额外小提醒 #

• 确保请求头里的boundary和请求体里的分隔符完全一致（你提供的请求示例是正确的）；
• 如果你的JAX-RS实现是RESTEasy之类的其他框架，依赖和配置会略有不同，但核心思路一样：引入multipart解析依赖，注册对应的Feature/Provider。

这样修改后，你的API就能正确解析multipart/mixed类型的请求，不会再出现415异常了。

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