Jackson需配置FAIL_ON_UNKNOWN_PROPERTIES=false或@JsonIgnoreProperties(ignoreUnknown=true)；Gson默认忽略未知字段；Java原生序列化不支持忽略，新增字段须设transient或维护serialVersionUID。

Java 中反序列化时忽略新增的未知字段，关键取决于你使用的序列化/反序列化框架。最常见的是 Jackson（JSON）和 Java 原生序列化（ObjectInputStream），两者处理方式完全不同。

使用 Jackson 时忽略未知字段

Jackson 默认会因遇到 JSON 中存在但目标类中没有对应字段而抛出 UnrecognizedPropertyException。要忽略这些字段，有以下几种方式：

• 全局配置（推荐）：在 ObjectMapper 初始化时设置

objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

这样所有反序列化操作都会跳过未知字段，不报错也不赋值。

• 类级别控制：在目标类上加注解

@JsonIgnoreProperties(ignoreUnknown = true)
public class User { ... }

该注解只对当前类生效，子类不继承，适合局部控制。

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• 包或模块级配置：通过 SimpleModule 或 @JsonFormat 等扩展方式也可实现，但较少用，一般优先选全局或类级。

使用 Gson 时忽略未知字段

Gson 默认就忽略未知字段，无需额外配置。如果你发现它报错，可能是启用了严格模式：

• 确认没调用 new GsonBuilder().setLenient().create() —— 其实 setLenient() 是针对 JSON 格式宽松（如换行、注释），不影响字段识别；
• 真正影响字段的是 serializeNulls() 或 excludeFieldsWithoutExposeAnnotation()，和未知字段无关；
• 默认行为就是静默跳过 JSON 中多出来的字段，无需干预。

Java 原生序列化（ObjectInputStream）不支持“忽略未知字段”

Java 原生 Serializable 机制不兼容字段增减：
一旦类增加了新字段（且未显式定义 serialVersionUID），反序列化旧数据时会因 InvalidClassException 失败；即使定义了 serialVersionUID，新增字段也会被设为默认值（如 null、0、false），但不会“忽略”——它仍参与序列化协议校验。

所以原生方式下：

• 新增字段必须是 transient 才能真正跳过序列化/反序列化；
• 否则应始终维护 serialVersionUID，并确保兼容性（如新字段提供默认值、重写 readObject() 自定义逻辑）；
• 若需灵活应对结构变化，不建议用原生序列化，改用 Jackson/Gson 等可配置的 JSON 方案。

小结：按场景选择策略

• 用 Jackson → 配置 FAIL_ON_UNKNOWN_PROPERTIES = false 或加 @JsonIgnoreProperties；
• 用 Gson → 默认已忽略，基本不用管；
• 用 ObjectInputStream → 不具备“忽略”能力，本质是二进制协议强约束，应避免字段随意变更。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南