news 2026/3/3 22:46:45

Spring Boot 4 全面拥抱 Jackson 3

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Spring Boot 4 全面拥抱 Jackson 3

Spring Boot 4 将默认 JSON 库从Jackson 2切换到了Jackson 3

如果你是资深 Spring Boot 应用开发者,Jackson 一定不陌生,它是 Spring Boot 中Java 对象 ↔ JSON的事实标准。

Jackson 在 Spring Boot 4 中依赖结构大致是这样:

spring-boot-starter-jackson (4.x)├── tools.jackson.core:jackson-core:3.x ← Jackson 核心库└── com.fasterxml.jackson.annotation:jackson-annotations:2.x ← Jackson 注解

所以很多人在第一次查看项目依赖树时都会愣一下:

为什么项目里同时存在 Jackson 2 和 Jackson 3?

这是 Jackson 团队为了解决一个非常现实的问题:

整个 Java 生态不可能一夜之间全部迁移到 Jackson 3

他们的解决方案是:

核心实现迁移到新包名注解继续沿用旧包名

这意味着:

@JsonView@JsonFormat@JsonIgnore•......

这些你用烂了的注解完全不用改, 可以让多个项目在 Jackson 2 / 3 之间渐进式迁移。

这是一次非常工程化、也非常现实的设计。

Spring Boot 4 默认升级到 Jackson 3 后,并不是换个版本号这么简单。 下面这 4 个变化,每一个都可能在升级时踩坑。

1. 包名变了:从com.fasterxml.jacksontools.jackson

这是最直观、也是最容易编译报错的地方。

// Jackson 2import com.fasterxml.jackson.databind.ObjectMapper;// Jackson 3import tools.jackson.databind.ObjectMapper;

注意:

只有核心 API 换包名,注解依然在com.fasterxml.jackson.annotation

2.ObjectMapper退出舞台,JsonMapper成为主角

Jackson 2 的ObjectMapper可变的

​​​​​​​

ObjectMapper mapper = new ObjectMapper();mapper.enable(SerializationFeature.INDENT_OUTPUT);

这在多线程环境下其实并不安全。

Jackson 3 强制你使用Builder + Immutable(不可变)模式:

​​​​​​​

JsonMapper mapper = JsonMapper.builder().enable(SerializationFeature.INDENT_OUTPUT).disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES).build();

一旦build()

•配置被锁死•可以安全共享•天然线程安全

这是 Jackson 3 非常重要的一次设计升级。

Jackson 3 直接创建的ObjectMapper只能得到默认配置,如果需要自定义配置,必须使用JsonMapper.builder()来创建不可变、线程安全的实例。

3. 日期序列化的默认值变了(非常容易踩坑)

版本

默认序列化

Jackson 2

时间戳

Jackson 3

ISO-8601 字符串

​​​​​​​

// Jackson 2{"nowDate": 1767588151648}// Jackson 3{"nowDate": "2026-01-05T02:02:31.648Z"}

这对前端更友好,但会导致:

•依赖时间戳断言的老测试用例失败•与时间格式强绑定的接口约定、Mock 数据需要同步调整

临时兼容方案:

​​​​​​​

spring:jackson:use-jackson2-defaults: true

该配置会让 Jackson 3 尽量保持 Jackson 2 的默认行为,适合在迁移初期使用。

4.Checked Exception终于被干掉了

这是很多 Java 开发者拍手叫好的改动。

Jackson 2:

​​​​​​​

try {objectMapper.readValue(json, MyClass.class);} catch (IOException e) {...}

Jackson 3:

jsonMapper.readValue(json, MyClass.class);

所有异常都继承自JacksonExceptionRuntimeException)。

最直接的好处是:

​​​​​​​​​​​​​​

// Jackson 2:lambda 直接崩list.stream().map(o -> objectMapper.writeValueAsString(o)).toList();// Jackson 3:完全没问题list.stream().map(o -> jsonMapper.writeValueAsString(o)).toList();

这是真正为现代 Java 写法服务的设计。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/2/28 15:47:06

复旦团队发现:AI教学助手能力需精准匹配学生水平

这项由复旦大学、上海人工智能实验室等多个机构联合完成的研究于2026年1月发表在arXiv预印本平台,论文编号为arXiv:2601.14249v1。有兴趣深入了解的读者可以通过该编号查询完整论文。在人工智能快速发展的今天,我们经常听到这样一个说法:要想…

作者头像 李华
网站建设 2026/2/17 10:19:05

施密特触发器在PLC输入电路中的作用解析:通俗解释

以下是对您提供的技术博文进行 深度润色与专业重构后的版本 。我以一名深耕工业控制领域十余年的嵌入式系统工程师兼PLC课程讲师的身份,重新梳理全文逻辑、强化工程语境、剔除AI腔调,并注入大量一线调试经验与设计权衡思考。文章已完全去除模板化结构(如“引言/总结/展望”…

作者头像 李华