Jackson 实现 JSON 与 Java 对象精准转换的关键在于按需转换，依赖正确配置的 ObjectMapper、合理注解及兼容 Jackson 的 Java 类结构；需满足无参构造器、getter/setter 规范，泛型用 TypeReference，时间类型注册 JavaTimeModule 并设时区。
Jackson 实现 JSON 与 Java 对象的精准转换，关键不在“能转”，而在“按需转”——即字段映射准确、类型处理可靠、空值/日期/嵌套结构可控。核心靠三样：正确配置的 ObjectMapper、合理使用的注解、以及符合 Jackson 约束的 Java 类结构。
确保 Java 类结构兼容 Jackson
Jackson 默认依赖标准 Java Bean 规范，否则反序列化会失败或字段为空：
- 必须提供无参构造方法（即使私有，Jackson 也能访问）
- 字段建议用 private + public getter/setter（仅读字段需提供 getter；仅写字段需提供 setter）
- 泛型集合需用
TypeReference显式声明，例如：
objectMapper.readValue(json, new TypeReference<List<User>>() {}) - 避免使用 Lombok 的
@Data时忽略无参构造器生成（应加@NoArgsConstructor）
用注解控制字段级映射行为
单靠默认规则容易出错，比如字段名不一致、敏感字段泄露、空值冗余等。常用注解如下：
-
@JsonProperty("user_name")：强制指定 JSON 键名，解决驼峰与下划线命名差异 -
@JsonIgnore或@JsonIgnoreProperties({"password", "token"})：明确排除不参与序列化的字段 -
@JsonInclude(JsonInclude.Include.NON_NULL)：序列化时跳过 null 值字段（类级别或全局配置均可） -
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")：精确控制LocalDateTime或Date的格式，避免时间戳或时区混乱 -
@JsonAlias({"oldName", "v1_name"})：反序列化时兼容多个旧字段名（Jackson 2.12+）
定制 ObjectMapper 提升健壮性
全局配置比每个类加注解更高效，也更适合统一规范：
立即学习“Java免费学习笔记（深入）”；
- 启用常见特性：
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false) —— 忽略 JSON 中多出的未知字段，避免反序列化失败 - 统一空值处理：
objectMapper.setSerializationInclusion(JsonInclude.Include.NON_EMPTY) - 注册 Java 8 时间模块（必加，否则
LocalDateTime会报错）：
objectMapper.registerModule(new JavaTimeModule()) - 设置默认时区（避免时间解析偏差）：
objectMapper.setTimeZone(TimeZone.getTimeZone("GMT+8"))
处理泛型、继承与动态结构
复杂场景需额外机制保证精度：
- 泛型反序列化不用
User.class，改用TypeReference<Map<String, List<Order>>> - 多态类型（如父类
Animal，子类Dog/Cat）用@JsonTypeInfo+@JsonSubTypes标明类型标识字段和映射关系 - 不确定结构的 JSON 可先解析为
JsonNode，再按路径提取：
JsonNode root = objectMapper.readTree(json); String name = root.path("data").path("user").path("name").asText();
