ObjectMapper 默认序列化忽略 null 字段,需设 JsonInclude.Include.ALWAYS;下划线转驼峰用 PropertyNamingStrategies.SNAKE_CASE;LocalDateTime 需注册 JavaTimeModule;泛型反序列化必须用 new TypeReference<>() {}。

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<user></user>,但写成 objectMapper.readValue(json, List.class) 会得到 List<map></map>,字段全丢。
立即学习“Java免费学习笔记(深入)”;
- 必须用
TypeReference:objectMapper.readValue(json, new TypeReference<list>>() {})</list> - 注意括号位置:
new TypeReference<list>>() {}</list>是匿名子类,少一对括号或写成TypeReference<list>></list>(没 new)都会编译失败或运行时报错 - 如果类型嵌套深(比如
Map<string list object>>></string>),手写TypeReference易错,建议拆成变量或用工具类封装
Jackson 的坑多数藏在「默认配置」和「类型擦除」里。配错一个模块、漏写一个 TypeReference、或者命名策略没对齐,表面没报错,实际数据就悄悄丢了。










