前后端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数组。
立即学习“Java免费学习笔记（深入）”；
解决方案
解决方法主要有两种：调整前端数据格式或修改后端代码进行数据处理。
-
调整前端JSON数据格式： 前端应确保发送的是一个JSON数组，而不是JSON字符串。 假设后端期望接收一个
List，前端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 ... */ }
]
}
- 修改后端代码： 如果无法立即修改前端代码，后端可以修改代码，接收字符串，然后手动解析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错误，并预防此类问题的再次发生。
