使用ObjectMapper反序列化含嵌套数组的JSON为Java对象问题求助

以下是常见的问题原因及修复方法： #

1. 代码笔误优先排查 #

提供的反序列化代码存在明显笔误，返回值类型和接收变量不匹配，如果实际代码也是这么写的会直接导致类型转换异常，即使上层字段赋值成功也会影响后续取值：

// 错误写法
ObjectMapper mapper = new ObjectMapper();
Defect defect = mapper.readValue(jsonString, Person.class);

// 修正写法
ObjectMapper mapper = new ObjectMapper();
Person person = mapper.readValue(jsonString, Person.class);

2. Getter/Setter 正确性校验 #

Jackson默认依赖公有getter、setter方法完成字段映射，拆分到不同文件后需要确认以下三类方法都正确生成：

• Person类存在public AddressList getAddressList()和public void setAddressList(AddressList addressList)
• AddressList类存在public List<Address> getData()和public void setData(List<Address> data)、public int getCount()和public void setCount(int count)
• Address类存在state和city对应的公有getter、setter方法
  如果使用Lombok自动生成注解，确认没有额外的@JsonIgnore、@JsonIgnoreProperties注解误屏蔽了相关字段。

3. ObjectMapper 配置校验 #

如果ObjectMapper手动配置了命名策略，会导致驼峰命名的字段匹配失败：

// 错误配置示例：开启蛇形命名策略后，Jackson会自动将JSON字段转为下划线格式匹配
// 会把addressList转为address_list，和JSON中的字段不匹配，导致赋值失败
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);

如果确实需要保留全局蛇形命名配置，可以给对应字段加@JsonProperty注解手动指定匹配的JSON字段名：

public class Person {
    private String name;
    private int age;
    @JsonProperty("addressList")
    private AddressList addressList;
    // 其余代码不变
}

4. 无参构造方法访问权限校验 #

三个实体类拆分到独立文件后，需要确认无参构造方法的修饰符都是public，如果缺省public修饰符，Jackson无法跨包反射创建实例，会跳过对应字段的赋值。 #

5. 开启报错提示定位问题 #

可以临时开启Jackson的报错配置，快速定位匹配失败的具体原因：

ObjectMapper mapper = new ObjectMapper();
// 遇到未知属性时报错，避免静默忽略匹配失败的字段
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, true);

运行后如果抛出异常，可根据异常信息直接定位到是哪个字段、哪个层级出现了匹配问题。

内容的提问来源于stack exchange，提问作者Shan C