本文深入解析 jackson 在零配置（无注解、无自定义反序列化器）下如何完成 json 到 java 对象的默认反序列化，重点阐明无参构造器的可见性要求、多构造器共存时的行为、无无参构造器时的失败机制，以及 setter 与反射的协同逻辑。
本文深入解析 jackson 在零配置（无注解、无自定义反序列化器）下如何完成 json 到 java 对象的默认反序列化，重点阐明无参构造器的可见性要求、多构造器共存时的行为、无无参构造器时的失败机制，以及 setter 与反射的协同逻辑。
Jackson 的默认反序列化流程严格遵循一套可预测、优先级明确的策略。其核心前提是：必须存在一个可访问的无参构造器（zero-argument constructor），且所有目标 JSON 字段需通过 public setter 方法或直接字段赋值（需开启 MapperFeature.ALLOW_FINAL_FIELDS_AS_MUTATORS 等非默认选项）进行设置。以下分四点展开说明，并附关键实践结论。
✅ 1. 无参构造器无需 public —— private 亦可
Jackson 使用反射机制调用构造器，对访问修饰符无强制要求。只要构造器存在（哪怕为 private），Jackson 即可通过 setAccessible(true) 绕过 Java 访问控制。
public class Person {
private int id;
private String name;
private Person() { // ← private 合法！
System.out.println("Private no-args invoked");
}
public void setId(int id) { this.id = id; }
public void setName(String name) { this.name = name; }
}
✅ 反序列化成功：Jackson 先调用 private Person()，再依次调用 setId() 和 setName()。
✅ 2. 多构造器共存 —— Jackson 忽略其他构造器
当类同时声明 public Person() 和 public Person(int, String) 时，Jackson 仅识别并使用无参构造器，完全忽略带参构造器（无论 public/private）。即使将无参构造器设为 private，也不会触发带参构造器的自动选用。
public class Person {
private int id; private String name;
private Person() { /* ... */ } // ← Jackson 唯一选用
public Person(int id, String name) { /* ... */ } // ← 完全被忽略
public void setId(int id) { this.id = id; }
public void setName(String name) { this.name = name; }
}
✅ 行为稳定：无参构造器是唯一入口，其余构造器不影响默认反序列化流程。
❌ 3. 无无参构造器 → 直接抛 InvalidDefinitionException
若类仅提供带参构造器（如 Person(int, String)），且未添加 @JsonCreator 注解，Jackson 默认模式下无法构造实例，抛出明确异常：
Cannot construct instance of `Person` (no Creators, like default constructor, exist)
⚠️ 注意：此错误与字段缺失无关，而是构造阶段失败。此时必须显式启用 @JsonCreator + @JsonProperty，或注册 ParameterNamesModule（需编译时保留参数名 -parameters）。
⚙️ 4. 默认模式下不支持“部分参数构造器 + setter 混合”
问题中设想的“用 Person(String name) 构造，再调用 setId() 补全”在纯默认模式下不可行——因为 Jackson 首先就找不到无参构造器，根本不会进入后续 setter 调用阶段。
只有在显式启用 @JsonCreator 后，该混合策略才生效：
public class Person {
private int id; private String name;
@JsonCreator
public Person(@JsonProperty("name") String name) {
this.name = name; // ← 构造器初始化 name
}
public void setId(int id) { this.id = id; } // ← Jackson 自动调用补全 id
}
✅ 此时 Jackson 执行两步：① 调用 @JsonCreator 标记的构造器；② 对剩余 JSON 字段（如 "id"）调用匹配的 setter。
? 总结：默认反序列化的黄金法则
- 必要条件：至少一个无参构造器（任意访问级别）+ 所有 JSON 字段对应 public setter 方法。
- 禁止假设：Jackson 不会自动选择带参构造器，不依赖字段名/类型推断，不混合使用构造器与 setter（除非显式注解）。
- 调试提示：UnrecognizedPropertyException 通常表示 setter 缺失或命名不匹配；InvalidDefinitionException 则直指构造器缺失。
- 升级建议：若需更灵活的构造策略，应主动引入 @JsonCreator、@JsonProperty 或 ParameterNamesModule，而非依赖默认行为。
遵循上述规则，即可精准掌控 Jackson 默认反序列化行为，避免隐式失败与难以定位的异常。
