本文详解如何通过 maven 的 dependencymanagement 机制统一管理 jackson 等跨模块依赖版本，避免因多版本共存导致的 invaliddefinitionexception 等运行时异常，无需手动 exclusion 即可实现兼容性与可维护性兼备的构建方案。
本文详解如何通过 maven 的 dependencymanagement 机制统一管理 jackson 等跨模块依赖版本，避免因多版本共存导致的 invaliddefinitionexception 等运行时异常，无需手动 exclusion 即可实现兼容性与可维护性兼备的构建方案。
在 Java 多模块 Maven 项目中，当主应用（如 WAR）直接引入 oms.jar 和 cms.jar 这类自研第三方 JAR 包，且这些 JAR 内部又嵌套了不同版本的 Jackson（如 jackson-core、jackson-databind）时，极易触发 InvalidDefinitionException 或 NoSuchMethodError 等 Classpath 冲突问题。根本原因并非“重复引入”，而是 Maven 的依赖调解（Dependency Mediation）机制选择了不兼容的版本——例如你的主 POM 声明了 2.6.1，而 oms.jar 编译时依赖的是 2.9.10，二者 API 差异导致序列化器初始化失败。
此时简单使用 <exclusion> 虽可临时绕过错误，但会带来严重隐患：
- ❌ oms.jar/cms.jar 内部调用 Jackson 的逻辑可能因缺失依赖而崩溃；
- ❌ 维护成本陡增：每次升级自定义 JAR 都需重新检查并调整 exclusion 列表；
- ❌ 违背“依赖由提供方声明，消费方协调”的最佳实践。
✅ 正确解法是 主动控制依赖解析结果，而非被动排除。核心策略如下：
一、统一 Jackson 版本（推荐 2.13.x 或更高 LTS 版）
Jackson 官方强烈建议同一应用中所有模块使用 相同主版本号（如 2.13.5），因其保持二进制兼容性。请优先升级主应用及所有自定义 JAR 所依赖的 Jackson 至兼容版本（如 2.13.5）。若无法修改 oms.jar/cms.jar 源码，则通过 <dependencyManagement> 强制锁定：
<dependencyManagement>
<dependencies>
<!-- 统一 Jackson 主版本，影响所有 transitive 依赖 -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.13.5</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.13.5</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.13.5</version>
</dependency>
</dependencies>
</dependencyManagement>✅ 关键点：<dependencyManagement> 不直接引入依赖，但为所有子模块（包括 oms.jar、cms.jar 的传递依赖）设定版本仲裁规则。Maven 将优先采用此处声明的版本，而非各 JAR 自带的 pom.xml 中指定的旧版。
二、验证依赖树，确认版本生效
执行以下命令检查实际解析结果：
mvn dependency:tree -Dincludes=com.fasterxml.jackson.core:jackson-databind
输出中应仅出现 2.13.5（或你指定的版本），且无 omitted for conflict 提示。若仍显示旧版本，请检查：
- 是否遗漏 <dependencyManagement> 的 <scope>（此处无需 scope）；
- oms.jar/cms.jar 是否以 system 或 provided 方式引入（此类依赖不受 dependencyManagement 管控）；
- 是否存在父 POM 覆盖了当前配置。
三、进阶建议：推动模块化改造
长期来看，应推动 oms 和 cms 项目发布为标准 Maven 依赖（而非预编译 JAR），并在其 pom.xml 中将 Jackson 声明为 compile 依赖（非 system 或 lib 目录硬编码）。这样主应用可通过 <dependencyManagement> 全局管控，同时享受依赖传递、版本继承等 Maven 原生能力。
四、注意事项
- ⚠️ 勿滥用 <optional>true</optional>：该标签适用于“功能可选”场景（如某模块仅在启用特定特性时才需要某依赖），不适用于解决版本冲突。
- ⚠️ 慎用 <scope>provided</scope>：若将 Jackson 设为 provided，需确保运行环境（如 Tomcat）已预置对应版本，否则启动即报 ClassNotFoundException。
- ✅ 编码规范同步：统一 Jackson 版本后，务必检查主应用及 oms.jar/cms.jar 中的序列化代码（如 ObjectMapper 配置、注解用法），避免使用已被弃用的 API。
通过 <dependencyManagement> 实现依赖版本收敛，是 Maven 工程化治理的核心手段。它既消除了脆弱的手动 exclusion，又保障了模块间协作的稳定性。记住：冲突不是依赖太多，而是版本太乱；解决之道不在删减，而在统一。
