怎么排查Dependency依赖错误

排查依赖（Dependency）错误，通常要按「先看错误现象 → 定位是哪一类依赖问题 → 逐步缩小范围」的思路来做。下面按常见场景 + 排查步骤给你一个通用清单，适用于 Maven / Gradle / npm / pip / Go 等大多数生态。

一、先判断是哪种依赖错误

常见类型：

1. 找不到依赖（NotFound / Cannot resolve）
2. 版本冲突（Version Conflict / NoSuchMethod）
3. 循环依赖（Circular Dependency）
4. 依赖未生效（没打进包 / 运行时缺失）
5. 环境不一致（本地好，CI/线上报错）

二、通用排查流程（强烈推荐按顺序）

1️⃣ 看完整错误日志（最重要）

不要只看第一行，重点看：

• 是哪个 依赖名 + 版本
• 是 编译期 还是 运行期
• 是否带有 Caused by

✅ 技巧：

• Java：mvn dependency:tree / gradle dependencies
• npm：npm ls 包名
• Python：pip show 包名
• Go：go mod graph

2️⃣ 确认依赖是否真的存在

检查：

• 包名是否拼错
• 版本号是否存在（去官方仓库确认）
• 是否私有仓库未配置

示例：

# Maven
mvn dependency:get -Dartifact=com.xxx:yyy:1.0.0

# npm
npm view 包名 versions

3️⃣ 查依赖树（解决版本冲突核心手段）

Maven

mvn dependency:tree

看是否有：

|- A:1.0
|  \- B:2.0
|- C:1.0
   \- B:1.0  ❌ 冲突

解决：

• exclusions 排除
• 显式声明统一版本

npm

npm ls 包名

若有多个版本：

npm dedupe

4️⃣ 清理缓存（经常能救命）

# Maven
mvn clean install -U

# npm
rm -rf node_modules package-lock.json
npm install

# pip
pip install --force-reinstall 包名

5️⃣ 检查作用域 / 打包方式

常见问题：

• test 依赖在主代码用
• provided 依赖线上缺失
• frontend 依赖没打进 build

✅ 检查：

• Maven scope
• npm dependencies vs devDependencies
• Docker 是否 COPY 了依赖

6️⃣ 环境一致性排查

对比：

• JDK / Node / Python 版本
• OS
• 是否使用了不同的 mirror

✅ 建议：

• 使用 .tool-versions / nvm / docker

三、典型错误速查表

四、如果还是查不出

你可以把以下信息发我，我可以直接帮你分析：

1. 使用的语言 & 构建工具
2. 完整报错信息（关键部分即可）
3. 依赖配置文件（pom.xml / package.json / go.mod）
4. 是否已试过清理缓存

如果你愿意，可以直接贴错误，我可以手把手帮你定位。