前后端JSON数据映射异常：如何解决`Cannot deserialize instance of java.lang.String out of START

前后端JSON数据映射异常：如何解决`Cannot deserialize instance of java.lang.String out of START_ARRAY token`错误？

碧海醫心

发布： 2025-02-24 19:20:22

原创

903人浏览过

前后端json数据映射异常：如何解决`cannot deserialize instance of java.lang.string out of start_array token`错误？

前后端JSON数据交互异常及解决方案

问题：后端接口使用@RequestBody接收前端JSON数据时，报错Cannot deserialize instance of java.lang.String out of START_ARRAY token。

问题根源

错误提示表明，后端期望接收一个数组(START_ARRAY token)，但实际收到的是一个字符串(java.lang.String)。这通常是因为前端发送的JSON数据格式与后端期望的格式不一致。例如，后端定义了一个List<hkboattaskpath></hkboattaskpath>类型的属性，但前端却发送了一个该类型对象的JSON字符串表示，而不是一个JSON数组。

立即学习“Java免费学习笔记（深入）”；

解决方案

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

解决方法主要有两种：调整前端数据格式或修改后端代码进行数据处理。

调整前端JSON数据格式： 前端应确保发送的是一个JSON数组，而不是JSON字符串。假设后端期望接收一个List<hkboattaskpath></hkboattaskpath>，前端JSON数据应如下所示（示例）：

<code class="json">{
  "isapp": "forandroid",
  "taskname": "test",
  "pathlist": [
    {
      "createtime": "2022-07-13 16:34:32",
      "cycleindex": "1",
      "id": "347",
      "maxormin": [
        {"latitude": 30, "longitude": 120},
        {"latitude": 30, "longitude": 120}
      ],
      "pathname": "test1",
      "pathtype": "1",
      "pointlist": [
        {"latitude": 30, "longitude": 120},
        {"latitude": 30, "longitude": 120}
      ]
    },
    { /* ... other HkboatTaskPath objects ... */ }
  ]
}</code>

登录后复制

修改后端代码： 如果无法立即修改前端代码，后端可以修改代码，接收字符串，然后手动解析JSON字符串为对象列表。例如，使用Jackson库：

<code class="java">@PostMapping("/api/endpoint")
public ResponseEntity<Void> handleRequest(@RequestBody String jsonData) throws JsonProcessingException {
    ObjectMapper objectMapper = new ObjectMapper();
    JsonNode rootNode = objectMapper.readTree(jsonData);
    JsonNode pathList = rootNode.get("pathlist");
    List<HkboatTaskPath> paths = objectMapper.readValue(pathList.toString(), new TypeReference<List<HkboatTaskPath>>() {});
    // ... further processing of 'paths' ...
    return ResponseEntity.ok().build();
}</code>

登录后复制

预防措施

为了避免此类问题再次发生，建议：