You need to enable JavaScript to run this app. Java REST服务接收指定结构JSON时出现JSON解析反序列化报错
优惠活动
大模型
产品
解决方案
定价
更多

Java REST服务接收指定结构JSON时出现JSON解析反序列化报错

错误核心原因

报错Can not deserialize instance of com.myproject.model.Request out of START_ARRAY的本质是JSON入参结构和你声明的实体类型完全不匹配:

  • Spring默认使用Jackson做JSON反序列化,当接口入参用@RequestBody Request声明时,Jackson会按照Request类的结构,要求接收的JSON是**对象开头(以{为起始标记)**的结构,即:
    {
      "person": [
        { "name": "xxx" }
      ]
    }
    
  • 你实际传入的入参是**数组开头(以[为起始标记)**的结构,数组内每个元素是一个带person键的对象,Jackson无法直接将数组结构映射为单个Request对象,因此抛出400解析异常。
  • 额外存在的结构错配:你在Request类中定义private List<Person> person,但实际入参里每个层级的person值都是单个对象(不是数组列表),就算修正了最外层的数组/对象结构错配,后续依然会出现「无法将单个对象反序列化为List类型」的解析错误。

保持JSON入参不变的解决步骤

  • 第一步:补充匹配入参层级的实体类
    移除原有Request类的结构定义(和入参完全不匹配),新增对应JSON数组单个元素的POJO,匹配{"person": 单个Person对象}的结构:
    // 对应JSON数组中每一个元素的结构
    public class PersonItem {
        private Person person;
        // 省略getter/setter
    }
    
    保留原有Person、Info类的定义即可,注意修正Person类中age字段的类型适配:当前age字段声明为XMLGregorianCalendar类型,需要确保Jackson有对应模块支持该类型的字符串值解析,避免后续字段解析失败。
  • 第二步:调整Controller层的入参声明
    将原来直接绑定Request的写法,改成用List承接最外层的数组结构:
    // 错误写法:入参类型为单个Request,和数组结构不匹配
    // @PostMapping("/api/test")
    // public void test(@RequestBody Request request) {}
    
    // 正确写法:最外层是数组,直接用List承接每个PersonItem元素
    @PostMapping("/api/test")
    public void test(@RequestBody List<PersonItem> requestBody) {
        // 业务逻辑可直接遍历requestBody,取出每个元素的person字段处理
    }
    
  • 可选优化(如果必须保留原Request类作为接口入参)
    如果不想改动Controller的入参类型,可通过自定义Jackson反序列化器,将数组结构手动转换为Request对象的结构,但这种方式会增加代码复杂度,优先推荐直接用匹配结构的类型承接入参。

内容的提问来源于stack exchange,提问作者Vlenovil

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.08 08:24:03