JacksonObjectMapper教程：序列化反序列化全解析

本文深入解析Jackson中ObjectMapper在JSON序列化与反序列化过程中的四大高频陷阱：如何正确保留null字段、精准处理下划线与驼峰命名转换、无缝支持LocalDateTime等Java 8时间类型，以及安全反序列化泛型集合——每一步都直击开发中“看似正常却数据丢失”的隐性bug根源，帮你避开默认配置和类型擦除埋下的坑，写出稳定可靠的JSON处理代码。

ObjectMapper 默认行为会忽略 null 字段

反序列化时 ObjectMapper 没问题，但序列化 Java 对象成 JSON 时，默认跳过值为 null 的字段——这常导致前端收不到预期的 key，以为后端漏传数据。

• 用 objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL) 是默认设置，要保留 null 就得显式改成 JsonInclude.Include.ALWAYS
• 如果只想对某个类生效，别全局改，直接在类上加 @JsonInclude(JsonInclude.Include.ALWAYS)
• 注意：@JsonInclude 在字段、getter、类三个层级都生效，优先级是字段 > getter > 类

反序列化时字段名不匹配（比如下划线转驼峰）

后端接收前端传来的 user_name，但 Java 实体用的是 userName，不配好就报 Unrecognized field "user_name" 错误。

• 最稳妥的是启用 PropertyNamingStrategies.SNAKE_CASE： objectMapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE)
• Java 10+ 用户注意：旧版叫 PropertyNamingStrategy.SNAKE_CASE，已废弃，别用错类名
• 如果只有一两个字段要特殊映射，比全局策略更轻量：在字段上加 @JsonProperty("user_name")

LocalDateTime 反序列化直接抛异常

没配模块时，ObjectMapper 遇到 LocalDateTime 会报 Cannot construct instance of java.time.LocalDateTime，因为它不认识这种“无参构造 + setter”的时间类型。

• 必须注册 JavaTimeModule： objectMapper.registerModule(new JavaTimeModule())
• 默认序列化格式是 ISO-8601（如 "2024-05-20T14:30:00"），若需自定义格式，加：javaTimeModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")))
• 别漏掉反序列化器：javaTimeModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")))

泛型集合反序列化写错 TypeReference 就出空对象

想把 JSON 数组 [{"id":1},{"id":2}] 反序列化成 List，但写成 objectMapper.readValue(json, List.class) 会得到 List，字段全丢。

• 必须用 TypeReference： objectMapper.readValue(json, new TypeReference>() {})
• 注意括号位置：new TypeReference>() {} 是匿名子类，少一对括号或写成 TypeReference>（没 new）都会编译失败或运行时报错
• 如果类型嵌套深（比如 Map>>），手写 TypeReference 易错，建议拆成变量或用工具类封装

Jackson 的坑多数藏在「默认配置」和「类型擦除」里。配错一个模块、漏写一个 TypeReference、或者命名策略没对齐，表面没报错，实际数据就悄悄丢了。

终于介绍完啦！小伙伴们，这篇关于《JacksonObjectMapper教程：序列化反序列化全解析》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！