IntelliJ IDEA中Maven依赖冲突导致编译失败时，应先通过Maven工具栏Dependencies节点或Dependency Analyzer的Conflicts页定位冲突Jar；再用mvn dependency:tree -Dverbose -Dincludes=groupId:artifactId命令精准查源；最后在父依赖中添加exclusions排除冲突项并重载项目。
当你在IntelliJ IDEA中新增一个Maven依赖后，项目突然编译失败，报出ClassNotFoundException或NoSuchMethodError，而控制台提示的类明明已在本地依赖中存在——这基本可以断定是Maven传递依赖引入了冲突版本的Jar包，必须立刻定位并剔除干扰项。
快速定位冲突Jar包
打开IDEA右侧Maven工具栏（快捷键 Alt+Shift+M），展开当前项目 → Dependencies节点。等待依赖树加载完成，【被灰色或红色标出的Jar包就是冲突项】；鼠标悬停在该Jar上，会显示“Provided by: xxx”字样，明确告诉你它是由哪个父依赖带进来的。
如果没看到明显标红，说明冲突未被IDEA自动识别，此时切到pom.xml文件，点击右下角出现的 Dependency Analyzer 标签页 → 切换到 Conflicts 子页，所有冲突依赖会集中列出，一目了然。
用命令行精准查源
方法一：在项目根目录终端执行：
mvn dependency:tree -Dverbose -Dincludes=groupId:artifactId
把 groupId 和 artifactId 替换成你从报错中提取的关键信息（例如 com.alibaba:fastjson）。-Dverbose 参数会强制显示被省略（omitted）的版本，-Dincludes 能过滤掉无关分支，大幅缩短输出长度。
方法二：若想全局扫描全部冲突，直接运行：
mvn dependency:tree | grep -E "omitted|conflict|version managed"
Linux/macOS系统下这条命令能高亮所有被跳过或管理的版本行，Windows用户可用PowerShell替代：mvn dependency:tree | Select-String "omitted|conflict"。
三步排除干扰依赖
第一步：在pom.xml中找到引入冲突Jar的那个父依赖（即Dependency Analyzer里显示的“Provided by”来源）。
第二步：在其 <dependency> 块内添加 <exclusions> 子节点，将冲突子依赖完整排除。格式必须严格：
<exclusion><br> <groupId>com.alibaba</groupId><br> <artifactId>fastjson</artifactId><br></exclusion>
注意：【exclusion中不能写<version>标签，写了会被忽略】，只靠groupId和artifactId就能精准匹配。
第三步：保存pom.xml → 点击IDEA右上角Maven面板的 Reload project 按钮（或右键项目 → Maven → Reload project），等待依赖重载完成。此时External Libraries中应只剩一个目标版本的Jar包。
