本文详解如何通过依赖版本对齐与 统一管理，避免因多版本 Jackson（如 jackson-core/jackson-databind）引发的 InvalidDefinitionException，从而消除对自定义 JAR（如 oms.jar、cms.jar）强制 exclusion 的必要。
本文详解如何通过依赖版本对齐与 `
在 Maven 多模块或集成第三方私有 JAR 的项目中，一个典型痛点是：主应用显式声明了 Jackson 2.6.1，而 oms.jar 和 cms.jar 内部又打包了不同版本（如 2.4.x 或 2.9.x）的 Jackson 类——导致运行时类加载器加载到不兼容的 ObjectMapper 或注解处理器，最终抛出 com.fasterxml.jackson.databind.exc.InvalidDefinitionException。此时若简单使用
根本解法不是“排除”，而是“统一”——让整个项目（包括所有依赖 JAR）共享同一套兼容的 Jackson 版本。以下是推荐的三步实践方案：
✅ 第一步：确认实际冲突版本
运行以下命令，可视化依赖树并定位 Jackson 版本分歧：
mvn dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind
输出中将清晰显示：
- 主 POM 声明的 jackson-databind:2.6.1
- oms.jar 传递引入的 jackson-databind:2.4.5
- cms.jar 传递引入的 jackson-databind:2.9.10
⚠️ 注意：Maven 默认采用“最近胜利（nearest wins）”策略，但 WAR 打包时 Servlet 容器（如 Tomcat/JBoss）的类加载顺序可能覆盖该规则，导致低版本优先加载——这正是异常根源。
✅ 第二步：升级并锁定 Jackson 版本（推荐 2.13.x 或 2.15.x）
Jackson 2.6.1（发布于 2015 年）已严重过时，存在已知反序列化漏洞及 API 不兼容问题。强烈建议升级至长期支持的稳定版本，例如 2.15.3（截至 2026 年仍获安全更新）：
在 pom.xml 的
<dependencymanagement><dependencies><!-- 统一 Jackson BOM（Bill of Materials）确保核心模块版本一致 --><dependency><groupid>com.fasterxml.jackson</groupid><artifactid>jackson-bom</artifactid><version>2.15.3</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencymanagement>
同时移除原有分散声明的 Jackson 依赖：
<!-- 删除以下三行（原 POM 中） --> <!-- <dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.6.1</version></dependency> --> <!-- <dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.6.1</version></dependency> --> <!-- <dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.6.1</version></dependency> -->
✅ 效果：所有 Jackson 模块（core、databind、annotations、jsonSchema）自动对齐至 2.15.3，且 oms.jar/cms.jar 中的旧版本在解析时会被 Maven 的“版本仲裁”机制自动降级（或忽略），不再参与 classpath 构建。
✅ 第三步：验证与加固（可选但关键）
-
启用依赖收敛检查：在 pom.xml 中添加插件，防止未来意外引入冲突版本：
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-enforcer-plugin</artifactid><version>3.4.1</version><executions><execution><id>enforce-dependency-convergence</id><goals><goal>enforce</goal></goals><configuration><rules><dependencyconvergence></dependencyconvergence></rules></configuration></execution></executions></plugin>
- 检查自定义 JAR 兼容性：联系 oms.jar/cms.jar 提供方，确认其是否支持 Jackson 2.15+；若不支持，需推动其升级或提供兼容补丁（Jackson 2.x 向后兼容性极佳，2.15 应兼容绝大多数 2.4+ 功能）。
? 总结
| 方案 | 是否推荐 | 原因 |
|---|---|---|
| ❌ 直接 |
否 | 掩盖问题，破坏封装，易引发运行时故障 |
| ⚠️ 强制 |
不推荐 | 依赖容器提供 Jackson，不可控且违背 WAR 自包含原则 |
| ✅ |
强烈推荐 | 标准化、可维护、符合 Maven 最佳实践，一劳永逸 |
最终，你将获得一个干净、可重现、无警告的构建：无需 exclusion，oms.jar 和 cms.jar 无缝集成，Jackson 功能完整可用，InvalidDefinitionException 彻底消失。
