Jackson 1.x到2.x的演进与Spring集成

Jackson 从 1.x 到 2.x 的演进，不仅是一次技术升级，更深刻影响了 Spring 生态（尤其是 Spring MVC 和 Spring Boot）的 JSON 处理方式。下面从Jackson 自身差异、Spring 对 Jackson 的集成变迁、实际开发中的迁移注意事项三个维度，系统梳理这一历程。

一、Jackson 1.x vs 2.x：核心差异回顾（精要版）

✅关键结论：两者二进制不兼容，不能共存于 classpath（会冲突）。

二、Spring 项目中 Jackson 的集成变迁

1.Spring Framework 3.x 时代（~2010–2013）

• 默认使用Jackson 1.x。
• 需手动添加依赖：

  <dependency><groupId>org.codehaus.jackson</groupId><artifactId>jackson-mapper-asl</artifactId><version>1.9.13</version></dependency>

• 在 Spring MVC 中启用 JSON：

  <mvc:annotation-driven/><!-- 自动检测 classpath 下的 Jackson 1.x -->

⚠️ 此时若想用 Jackson 2.x，需显式配置MappingJackson2HttpMessageConverter（名字带 “2” 就是为区分 1.x）。

2.Spring Framework 4.x 起（2013+）：全面拥抱 Jackson 2.x

• 默认且仅支持 Jackson 2.x。
• 移除对 Jackson 1.x 的自动配置支持。
• 新增核心类：
  • MappingJackson2HttpMessageConverter（取代旧的MappingJacksonHttpMessageConverter）
  • Jackson2ObjectMapperBuilder
• 自动配置条件：classpath 存在com.fasterxml.jackson.databind.ObjectMapper

Spring Boot 的推动（2014+）

• Spring Boot 1.0+ 默认内嵌 Jackson 2.x。
• starter 依赖自动引入：

  <dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><!-- 传递依赖 jackson-databind 2.x --></dependency>

• 通过application.properties轻松配置：

  spring.jackson.serialization.write-dates-as-timestamps=false spring.jackson.default-property-inclusion=NON_NULL

✅从此，新项目几乎不再接触 Jackson 1.x。

3.Spring Boot 2.x / 3.x：深度集成与现代化

• Jackson 2.9+ ~ 2.15+ 成为事实标准。
• 支持 Java 8+ 特性（Optional,LocalDateTime等开箱即用）。
• 通过Jackson2ObjectMapperBuilderCustomizer定制：

  @BeanpublicJackson2ObjectMapperBuilderCustomizerjsonCustomizer(){returnbuilder->builder.serializationInclusion(JsonInclude.Include.NON_EMPTY);}

• Spring Boot 3.x（基于 Jakarta EE 9+）：
  • 包名从javax.*→jakarta.*
  • 但 Jackson 不受影响（仍用com.fasterxml.jackson）

三、实际开发中的关键差异与迁移要点

场景 1：自定义序列化器

Jackson 1.x（已过时）：

importorg.codehaus.jackson.JsonGenerator;importorg.codehaus.jackson.map.JsonSerializer;importorg.codehaus.jackson.map.SerializerProvider;publicclassMySerializerextendsJsonSerializer<MyClass>{@Overridepublicvoidserialize(MyClassvalue,JsonGeneratorjgen,SerializerProviderprovider){jgen.writeString("custom");}}

Jackson 2.x（现代写法）：

importcom.fasterxml.jackson.core.JsonGenerator;importcom.fasterxml.jackson.databind.JsonSerializer;importcom.fasterxml.jackson.databind.SerializerProvider;publicclassMySerializerextendsJsonSerializer<MyClass>{@Overridepublicvoidserialize(MyClassvalue,JsonGeneratorgen,SerializerProviderserializers){gen.writeString("custom");}}

🔁只需改 import，逻辑几乎不变。

场景 2：注解使用变更

❌ Jackson 1.x 写法（在 2.x 中无效）：

@JsonSerialize(include=JsonSerialize.Inclusion.NON_NULL)privateStringname;

✅ Jackson 2.x 正确写法：

@JsonInclude(JsonInclude.Include.NON_NULL)publicclassUser{privateStringname;}// 或字段级@JsonInclude(Include.NON_EMPTY)privateList<String>tags;

📌这是最常见的迁移错误！

场景 3：Spring 配置类变更

Spring 3.x + Jackson 1.x：

@BeanpublicMappingJacksonHttpMessageConverterjacksonConverter(){returnnewMappingJacksonHttpMessageConverter();}

Spring 4.x+ + Jackson 2.x：

@BeanpublicMappingJackson2HttpMessageConverterjackson2Converter(){returnnewMappingJackson2HttpMessageConverter();}

注意类名多了“2”！

但在 Spring Boot 中，通常无需手动配置，自动装配即可。

场景 4：依赖冲突排查

若项目同时引入了 Jackson 1.x 和 2.x（例如老 jar 传递依赖），会出现：

• ClassNotFoundException
• NoSuchMethodError
• AbstractMethodError

解决方法：

# Maven 查看依赖树mvn dependency:tree|grepjackson# 排除旧版本<exclusion><groupId>org.codehaus.jackson</groupId><artifactId>jackson-mapper-asl</artifactId></exclusion>

四、总结：演进脉络与最佳实践

✅ 最佳实践（现代 Spring Boot 项目）：

1. 不要手动管理 Jackson 依赖，由spring-boot-starter-web控制版本。
2. 用@JsonInclude替代旧的include属性。
3. 自定义序列化/反序列化时，继承StdSerializer/StdDeserializer（比直接继承基类更安全）。
4. 全局配置优先使用application.yml，而非硬编码ObjectMapper。

如果你正在维护一个从 Spring 3.x 升级到 Spring Boot 的老系统，重点检查：

• 所有import org.codehaus.jackson...→ 替换为com.fasterxml.jackson...
• 所有@JsonSerialize(include=...)→ 改为@JsonInclude(...)
• 确保 classpath没有残留 Jackson 1.x 的 jar

这样就能平滑过渡到现代 Jackson 2.x 生态。