Morning Star 知识结晶 —— 将已解决问题的经验…

# 知识文档：Jenkins流水线Maven依赖冲突(fastjson版本共存)导致构建失败排查

一、问题现象

• Jenkins流水线执行Spring Boot服务的mvn package阶段构建失败
• 报错涉及fastjson相关类的编译错误/运行时异常（如NoClassDefFoundError、方法签名不匹配等）
• 本地构建与Jenkins环境行为不一致（可选，常见现象）

二、根因分析

• 项目依赖树中同时存在fastjson 1.2.75和fastjson 2.0.8
• fastjson 2.x的GroupId为com.alibaba.fastjson2，但某些过渡版本/兼容包（fastjson坐标下）可能导致同名类冲突或间接依赖拉入1.x版本
• 冲突来源通常是：不同第三方依赖各自传递依赖了不同版本的fastjson，Maven的“最近优先”策略在不同模块解析顺序下选中了非预期版本

三、排查思路（耗时约3小时）

1. 定位报错点：确认失败发生在哪个模块、哪个类，是否与JSON序列化相关

2. 查看依赖树：执行mvn dependency:tree -Dincludes=com.alibaba*（或fastjson2），输出重定向到文件分析

3. 识别双版本共存：在依赖树中发现fastjson 1.2.75与2.0.8并存，追踪各自的引入路径（哪个父依赖传递引入）

4. 对比本地与Jenkins环境：确认Maven版本、settings.xml、私服配置差异，排除环境因素

5. 确定修复策略：统一版本 + 加约束防止回归

四、解决方案

1. 统一依赖版本：在父POM的<dependencyManagement>中显式声明fastjson版本，覆盖传递依赖

2. 使用maven-enforcer-plugin防回归（核心措施）：

```xml

<plugin>

<artifactId>maven-enforcer-plugin</artifactId>

<executions>

<execution>

<goals><goal>enforce</goal></goals>

<configuration>

<rules>

<dependencyConvergence/>

<bannedDependencies>

<excludes>

<exclude>com.alibaba:fastjson:[0,1.2.80)</exclude>

</excludes>

</bannedDependencies>

</rules>

</configuration>

</execution>

</executions>

</plugin>

```

• dependencyConvergence：要求依赖版本收敛，冲突时直接构建失败并提示
• bannedDependencies：封禁低版本fastjson进入依赖树

3. 必要处显式排除：对引入旧版的第三方依赖用<exclusions>排除传递依赖

五、经验总结

• 依赖冲突优先用dependency:tree定位引入路径，不要盲目改代码
• `dependencyManagemen