本文详解如何在不额外定义中间包装类（如 PhoneList）的前提下，使用 Jackson 将形如 "phoneList": {"phone": [...]} 的嵌套 JSON 直接反序列化为 List<Phone> 字段，通过 @JsonProperty 配合反序列化 setter 实现优雅映射。
本文详解如何在不额外定义中间包装类（如 phonelist）的前提下，使用 jackson 将形如 `"phonelist": {"phone": [...]}` 的嵌套 json 直接反序列化为 `list
在实际开发中，我们常遇到 API 返回的 JSON 结构存在“冗余包装层”——例如 phoneList 并非直接是数组，而是包含 phone 字段的对象。此时若强行将字段声明为 List<Phone> phoneList，Jackson 默认会因类型不匹配而抛出 MismatchedInputException。但无需妥协：Jackson 提供了灵活的反序列化钩子机制，可通过反序列化专用 setter 方法绕过结构限制。
✅ 正确实现方式：使用 @JsonProperty 标注反序列化方法
关键在于：不将 phoneList 声明为字段，而是提供一个接受原始 JSON 对象（如 Map<String, List<Phone>>）的 setter 方法，并用 @JsonProperty("phoneList") 显式绑定该字段名。Jackson 会自动调用此方法完成解析与赋值。
以下是完整、可运行的 DTO 示例：
import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
public class Response {
private String name;
private List<Phone> phoneList = new ArrayList<>();
// 标准 getter/setter（Jackson 反序列化时非必需，但建议保留）
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public List<Phone> getPhoneList() { return phoneList; }
public void setPhoneList(List<Phone> phoneList) { this.phoneList = phoneList; }
// ? 核心：反序列化专用 setter
@JsonProperty("phoneList")
private void setPhoneListFromNestedObject(Map<String, List<Phone>> phoneListObj) {
if (phoneListObj != null && phoneListObj.containsKey("phone")) {
this.phoneList = phoneListObj.get("phone");
} else {
this.phoneList = new ArrayList<>();
}
}
public static class Phone {
private String number;
private Integer code;
// 必须提供无参构造器（Jackson 反序列化要求）
public Phone() {}
// getter/setter 略（实际使用中需补充）
public String getNumber() { return number; }
public void setNumber(String number) { this.number = number; }
public Integer getCode() { return code; }
public void setCode(Integer code) { this.code = code; }
}
}⚠️ 注意事项与最佳实践
- 必须有无参构造器：Response 和内部类 Phone 均需提供 public 或 package-private 无参构造器，否则 Jackson 无法实例化对象。
- 字段访问权限：setPhoneListFromNestedObject 方法可为 private，Jackson 通过反射可正常调用；但若启用安全管理器，需确保反射权限开放。
- 空值与健壮性处理：示例中已添加 null 和 containsKey 判断，避免 NullPointerException，生产环境强烈推荐。
- 避免命名冲突：该方法名（如 setPhoneListFromNestedObject）仅用于反序列化，与常规 setPhoneList(List<Phone>) 不冲突，Jackson 会优先匹配 @JsonProperty 标注的方法。
- 不推荐省略 getter/setter：虽然 Jackson 可通过字段直写（需配置 MapperFeature.INFER_PROPERTY_MUTATORS），但显式提供标准访问器更利于代码可维护性与 IDE 支持。
✅ 验证示例（JUnit）
ObjectMapper mapper = new ObjectMapper();
String json = """
{
"name": "test",
"phoneList": {
"phone": [
{"number": "32323232", "code": 555},
{"number": "4343423432", "code": 555}
]
}
}
""";
Response response = mapper.readValue(json, Response.class);
System.out.println(response.getPhoneList().size()); // 输出：2? 延伸提示：若需双向支持（即序列化时也输出为 {"phoneList":{"phone":[...]}}），可配合 @JsonSerialize 自定义序列化器；但多数场景下仅反序列化适配已足够。
综上，通过 @JsonProperty + 反序列化 setter 的组合，我们既保持了 DTO 的简洁性（零中间类），又完全兼容 Jackson 的标准解析流程，是处理“伪扁平化”嵌套 JSON 的专业级解决方案。
