17370845950

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

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

问题根源

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

解决方案

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

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

{
  "isapp": "forandroid",
  "taskname": "test",
  "pathlist": [
    {
      "createtime": "2025-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 ... */ }
  ]
}

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

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

预防措施

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

• 前后端约定数据格式： 在开发初期，前后端工程师应明确约定数据交换的格式，例如使用OpenAPI规范或其他接口定义语言。
• 严格的代码测试： 编写全面的单元测试和集成测试，验证前后端数据交互的正确性。
• 使用调试工具： 使用浏览器开发者工具或网络抓包工具检查实际发送和接收的JSON数据，以快速定位问题。
• 日志记录： 在代码中添加日志记录，记录请求和响应的数据，方便排查问题。

通过以上方法，可以有效解决Cannot deserialize instance of java.lang.String out of START_ARRAY token错误，并预防此类问题的再次发生。