FasterXML Jackson 3.0 模块化构建的演进：从Moditect到原生module-info.java

背景与挑战

在Java 9引入模块化系统后，许多库开始逐步适配JPMS（Java Platform Module System）。FasterXML Jackson作为Java生态中广泛使用的JSON处理库，在2.x版本中通过Moditect插件实现了模块化支持。这种方案的核心原因在于：2.x版本需要保持对JDK 8的兼容性，而JDK 8编译器无法直接处理module-info.java文件。

随着Jackson 3.0将最低JDK要求提升至17，开发团队决定转向更原生的模块化构建方式——直接使用javac编译module-info.java。这不仅简化了构建流程，还消除了对第三方插件的依赖，使模块声明更加直观和可维护。

技术实现细节

关键变更点

1. 构建工具链调整：

   • 移除Moditect插件配置
   • 将module-info.java作为标准源文件纳入编译流程
   • 确保所有模块（除特殊兼容性要求外）统一采用新方案

2. 特殊案例处理：

   • jackson-core模块因包含FastDoubleParser的shading操作，需要特殊配置确保模块路径正确
   • 多模块项目需保持一致的模块化策略，避免运行时出现分裂的模块图

3. 向后兼容考虑：

   • 虽然采用新构建方式，但仍需确保生成的字节码保持与旧版本的兼容性
   • 模块描述符中的requires transitive等关键指令需要精确控制

实施路线图

项目团队采用了分阶段实施策略：

1. 核心模块先行：

   • jackson-annotations（尽管最初计划保持JDK 8构建，最终也完成了转换）
   • jackson-core和jackson-databind这两个基础组件

2. 扩展模块跟进：

   • 数据格式模块（如XML处理）
   • 各种功能扩展模块

3. 验证与优化：

   • 确保模块边界清晰
   • 验证跨模块的依赖传递性
   • 优化模块化构建的编译性能

开发者启示

这一技术演进为其他库的模块化迁移提供了重要参考：

1. 版本规划：

   • 当目标运行时环境确定支持JPMS时，应优先考虑原生模块化方案
   • 大版本升级是调整构建策略的理想时机

2. 复杂依赖处理：

   • 对于包含代码shading等特殊操作的模块，需要设计额外的验证机制
   • 建议建立模块化测试套件，验证各模块的隔离性和可访问性

3. 渐进式迁移：

   • 可以保持一段时间的双模式支持（如同时提供自动模块和显式模块）
   • 重要变更应在主要版本中集中实施

未来展望

随着这一技术变更的完成，Jackson 3.0将获得更纯粹的模块化支持。这不仅提升了构建过程的透明度，也为后续可能的改进（如模块化测试、模块化文档生成等）奠定了更好的基础。对于使用者而言，更标准的模块化实现意味着更可预测的运行时行为和更简单的依赖管理。