本文详解如何通过依赖版本对齐与 <dependencyManagement> 统一管理，避免因多版本 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。此时若简单使用 <exclusion> 移除子 JAR 中的 Jackson，虽可“临时止血”，却埋下隐患：一旦 oms.jar 或 cms.jar 内部逻辑依赖特定 Jackson 行为（如自定义序列化器、模块注册），功能将悄然失效。
根本解法不是“排除”，而是“统一”——让整个项目（包括所有依赖 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> 之前）：
<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/></rules> </configuration> </execution> </executions> </plugin> - 检查自定义 JAR 兼容性：联系 oms.jar/cms.jar 提供方，确认其是否支持 Jackson 2.15+；若不支持，需推动其升级或提供兼容补丁（Jackson 2.x 向后兼容性极佳，2.15 应兼容绝大多数 2.4+ 功能）。
? 总结
| 方案 | 是否推荐 | 原因 |
|---|---|---|
| ❌ 直接 <exclusion> Jackson | 否 | 掩盖问题，破坏封装，易引发运行时故障 |
| ⚠️ 强制 <scope>provided</scope> | 不推荐 | 依赖容器提供 Jackson，不可控且违背 WAR 自包含原则 |
| ✅ <dependencyManagement> + BOM 统一版本 | 强烈推荐 | 标准化、可维护、符合 Maven 最佳实践，一劳永逸 |
最终，你将获得一个干净、可重现、无警告的构建：无需 exclusion，oms.jar 和 cms.jar 无缝集成，Jackson 功能完整可用，InvalidDefinitionException 彻底消失。
