使用JS向Java后端POST发字符串列表报unsupported media type错误如何解决

• JAX-RS（javax.ws.rs-api）仅为REST接口的抽象规范，本身不包含JSON序列化/反序列化实现。你可以直接接收String类型入参，是因为框架默认支持字符串类型的请求体转换；但要将JSON数组转换为List<String>这类泛型集合，需要额外引入对应的JSON处理Provider（如Jackson的JAX-RS适配包），无该Provider时框架无法识别application/json类型请求体对应泛型集合的转换逻辑，就会抛出不支持媒体类型的错误。
• Java泛型存在运行时擦除特性，List<String>在运行时会被擦除为原始类型List，如果JSON Provider无法拿到具体的泛型类型信息，也会因无法完成反序列化触发媒体类型匹配错误。

可根据技术栈选择任意一种适用方案：

方案1：替换入参为字符串数组（最简方案） #

数组不存在泛型擦除问题，框架可直接识别类型完成转换，仅需修改后端代码即可，前端无需调整：

@Path("/myPath")
@POST
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
public Response myMethod(String[] myList) {
   // 可通过Arrays.asList(myList)快速转换为List使用
   //do something
}

方案2：引入并注册JSON处理Provider #

以常用的Jackson实现为例：

1. 先引入对应适配依赖，如果你使用Jersey实现：

<!-- Jersey Jackson 适配依赖 -->
<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-json-jackson</artifactId>
    <version>与你的Jersey版本一致</version>
</dependency>

如果你使用RESTEasy实现：

<!-- RESTEasy Jackson 适配依赖 -->
<dependency>
    <groupId>org.jboss.resteasy</groupId>
    <artifactId>resteasy-jackson2-provider</artifactId>
    <version>与你的RESTEasy版本一致</version>
</dependency>

注意：依赖版本必须和你项目中使用的JAX-RS实现版本完全匹配，否则会出现Provider不注册的问题

2. 在JAX-RS配置类中注册Jackson功能，以Jersey的ResourceConfig为例：

public class MyRestConfig extends ResourceConfig {
    public MyRestConfig() {
        // 注册Jackson的JSON处理能力
        register(JacksonFeature.class);
        // 扫描你的接口所在包
        packages("你的接口所在包路径");
    }
}

配置完成后原有List<String>入参即可正常接收前端传来的JSON数组。

方案3：用包装类包裹列表（兼容性最好） #

如果以上方案都不生效，可以定义简单DTO包装类承载列表参数：

1. 定义DTO类：

public class MyListRequest {
    private List<String> myList;
    // 必须添加Getter、Setter方法，供Jackson反射读写属性
    public List<String> getMyList() { return myList; }
    public void setMyList(List<String> myList) { this.myList = myList; }
}

2. 修改后端接口入参：

@Path("/myPath")
@POST
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
public Response myMethod(MyListRequest request) {
   List<String> myList = request.getMyList();
   //do something
}

3. 对应调整前端请求的data结构：

var req = {
            method: 'POST',
            url: url,
            headers: {
                'Content-Type': 'application/json',
                'Accept': 'application/json'
            },
            data: {
                myList: ["a", "b"]
            }
        }

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