说起来，

概述

Jackson 是 Java 环境中最流行的 JSON 处理库。由 FasterXML 团队维护。它提供了高性能的 JSON 序列化与反序列化能力，很多地方都在用 Spring Boot、Dropwizard 等主流框架中。Jackson 的主要优势在于其流式 API 的高性能、注解驱动的灵活配置，还有对复杂 Java 类型的完整支持。不过，

Jackson 由三个主要模块组成。分别是 jackson-core、jackson-annotations 和 jackson-databind。jackson-core 提供底层的流式读写 API，jackson-annotations 定义所有注解。jackson-databind 则在两者之上建立出对象绑定能力。日常开发中只需引入 jackson-databind，它会自动传递依赖对了两个模块。按理说，

本教程基于 Jackson 版本。按照实际调用顺序组织内容：先讲序列化再讲反序列化，先讲简单类型再讲复杂类型，先讲字段筛选再讲字段转换。所有示例代码均可直接运行，读者可按章节顺序逐步实践。

再看痛点，依赖冲突和版本不兼容

在大型项目中。引入 Jackson 时常会遇到与其他 JSON 库或同一项目中的不同模块版本冲突的问题。建议统一使用同一系列的 jar，并通过 Maven/Gradle 的 exclusion 或 platform 管理依赖。

引入依赖

使用 Maven 时在 pom.xml 中添加 jackson-databind 依赖即可，它会自动引入 jackson-core 与 jackson-annotations。按理说，

com.fasterxml.jackson.core
jackson-databind
.

如果使用 Gradle。对应的配置如下，版本号可根据实际需要调整，本教程示例均基于 .x 系列。

implementation 'com.fasterxml.jackson.core:jackson-databind:.'

从痛点来看。忘记添加时间模块导致日期序列化失败

在处理 java.time 包下的类型时如果没有注册 JavaTimeModule，会出现日期格式错误或无法解析的问题。

ObjectMapper 主要入口

ObjectMapper 是 Jackson 的主要门面类，所有序列化与反序列化操作都通过它完成。一个 ObjectMapper 实例内部维护了类型工厂、序列化器缓存、反序列化器缓存等重型组件，所以它的创建成本较高。官方推荐将 ObjectMapper 作为单例复用，而不是每次请求都新建一个实例。ObjectMapper 本身是线程安全的，配置完成后可被多线程并发调用。

说到痛点，频繁创建 ObjectMapper 导致 GC 压力大增

MVC 请求每次都 new 一个 ObjectMapper 会产生大量临时对象。特别是在高并发环境下容易导致 GC 垃圾回收频繁触发，从而影响吞吐量和响应时间。

下面是最基础的 ObjectMapper 创建与使用示例。我们先定义一个简单的 POJO，接下来将其序列化为 JSON 字符串。

import com.fasterxml.jackson.databind.ObjectMapper;public class User {
private Long id;private String name;private Integer age;public User {}
public User {
this.id = id;this.name = name;
this.age = age;按理说，}
// getters & setters...
}

ObjectMapper 提供了一系列 writeValue 与 readValue 方法。分别用于序列化与反序列化。下面演示如何将对象转为 JSON 字符串，还有如何将 JSON 字符串转回对象。

ObjectMapper mapper = new ObjectMapper;// 序列化：对象 -> JSON 字符串
User user = new User;String json = mapper.writeValueAsString;老实说，// 输出：{"id":1,"name":"张三"。"age":28}
// 反序列化：JSON 字符串 -> 对象
User parsed = mapper.readValue;

序列化基础

序列化是将 Java 对象转换为 JSON 的过程。Jackson 默认会调用对象的所有 public getter 方法，将返回值作为 JSON 字段。字段名默认与属性名一致，字段顺序默认与声明顺序一致。按理说，对于简单类型，Jackson 内置了完整的序列化器支持，例如 String、Integer、Long、Double、Boolean 等基本包装类型。还有 BigDecimal、BigInteger、UUID、URL 等标准 Java 类型，都无需任何配置即可正确序列化。

@JsonFormat 格式日期输出

Date 类型默认被输出为时间戳。怎么说呢，如果想要更友好的格式。需要使用 @JsonFormat 或全局配置。再看例如，

@JsonFormat
private Date startTime;

@JsonInclude 控制空值输出

@JsonInclude 用来决定哪些字段应该被写入到 JSON 中，可以显著减小 Payload 大小。当业务只关心非空字段时这个注解非常有用：

@JsonInclude
public class Article {
private Long id;private String title;按理说，private String content;老实说，// null 时不输出
}

字段筛选技巧

在实际业务中。并非所有字段都应当输出到 JSON。例如密码、敏感信息或内部状态字段等需要隐藏或脱敏。在 Jackson 中可以通过多种注解实现精细控制：

@JsonIgnore 忽略单个字段

public class Account {
@JsonIgnore
private String password;// 不参与任何读写
}

@JsonProperty 密码脱敏示例

public class LoginRequest {
@JsonProperty
private String password;// 仅用于接收，不输出
}

@JsonInclude

• 痛点：    "我发现很多接口返回的数据里包含大量空字符串/空数组，为了减少网络流量，我需要快速去除这些无意义字段"
• 方法：    "在实体类上加 @JsonInclude。或者全局设置 mapper.setSerializationInclusion"
• 效果：    "仅保留非空数据，大幅缩短返回体积"

反序列化基础与常见问题排查

反序列化是把 JSON 转换为 Java 对象的一种方式。当输入数据结构变化时有时会导致异常抛出，如 UnrecognizedPropertyException 或 MismatchedInputException 等。这些错误往往是因为:

• P0: 未知属性导致异常 - 推荐开启 FAIL_ON_UNKNOWN_PROPERTIES=false 或使用 @JsonIgnoreProperties
• P1: 数值溢出 - 可以关闭 FAIL_ON_NUMBERS_FOR_ENUMS 或自定义 DeserializationFeature.ACCEPT_FLOAT_AS_INT 等特性来宽松解析数值类型
• P2: 日期解析失败 - 在对应属性上使用 @JsonFormat 并注册 JavaTimeModule；若有多种格式则自定义 MultiFormatDateDeserializer
• P4: 缺失必填字段 - 可通过 @NotNull + Validation 注解结合 Spring Validator 校验；或者给属性设置 defaultValue

痛点汇总

&n th ="align=center ">06 th ="align=center ">Large payload due to null/empty fields th ="align=center ">Set global inclusion NONNULL/NON_EMPTY. &n th ="align=center ">07 th ="align=center ">Performance overhead from repeated ObjectMapper instantiation th ="align=center ">Reuse a singleton instance and avoid per-request construction. &n th ="align=center ">08 th ="align=center ">Complex generic type deserialization fails th ="align=center ">Use TypeReference or construct JavaType via TypeFactory. &n th ="align=c o r e n t e r s e l f h e l p o r m i n g c o m p u t a t i o n s s c h u l d i m p r o v e h e r c h e c k i n g y o u b l w a y s f a i l u r e . h j k w n i n g j x w g m t a p z c q y z y z s q b v s d f z x w m f k v q g b w j x p f z q s x l c b j v w h d r c p r l u o j f m g k v s n .

#	问题描述	快速修复方式
01	UnrecognizedPropertyException	Avoid by disabling FAILONUNKNOWNPROPERTIES globally or using @JsonIgnoreProperties.
02	Empty bean serialization error	Add getters/setters or use Lombok's @Data.
03	MismatchedInputException	Edit field types or use custom deserializers.
04 05 t d ="align=center ">Date parsing error t d ="align=center ">Add @JsonFormat or register a custom date deserializer.

以上内容覆盖从 引入 到 高级定制 的完整流程，并针对开发中经常遇到的问题提供了实用方法。掌握这些技巧后你可以快速搭建稳定、业务需求对 JSON 的精准控制。

---