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
相关产品推荐
相关产品推荐

