Dependency依赖为何缺失

“Dependency 依赖为何缺失”通常出现在 Java（Maven / Gradle）、前端（npm / yarn / pnpm）、Python（pip / poetry） 等构建或运行阶段。下面按常见原因系统性说明，并给出排查思路。

一、最常见原因汇总

1. 依赖未声明

• Maven：pom.xml 中未写 <dependency>
• Gradle：未写 implementation 'xxx'
• npm：未执行 npm install xxx
• Python：未写进 requirements.txt / pyproject.toml

✅ 检查：

# Maven
mvn dependency:tree

# npm
npm ls <package>

2. 仓库（Repository）配置问题

• 私有仓库未配置
• 公司 Nexus / Artifactory 不可达
• npm 源被切换（如淘宝源缺失包）

✅ 检查：

# Maven
<repositories> 是否包含所需仓库

# npm
npm config get registry

3. 网络 / 代理问题

• 公司网络限制
• 未配置代理
• 防火墙阻断下载

✅ 表现：

• Could not resolve dependencies
• Connection timeout

4. Scope（作用域）错误

以 Maven 为例：

• test：只在测试可用
• provided：运行时不包含
• runtime：编译时不包含

✅ 错误示例：

<scope>provided</scope> <!-- 运行环境缺失 -->

5. 版本冲突 / 被排除

• 被 exclusions 排除
• 被 BOM 覆盖版本
• 多模块版本不一致

✅ 检查：

mvn dependency:tree

6. 本地仓库损坏

• .m2/repository 文件不全
• npm node_modules 损坏

✅ 解决：

# Maven
rm -rf ~/.m2/repository/xxx

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

7. 构建工具缓存问题

• Gradle 缓存旧状态
• IDE 未刷新依赖

✅ 解决：

• IDE：Reload / Reimport
• Gradle：--refresh-dependencies

8. 环境不一致

• 本地有依赖，CI 没有
• 不同 JDK / Node 版本

✅ 原则：

依赖必须可复现，不能“本地能跑”

二、快速排查清单（通用）

1. 是否声明了依赖？
2. 是否能访问仓库？
3. 是否网络/代理问题？
4. Scope 是否正确？
5. 是否被排除或冲突？
6. 本地缓存是否损坏？
7. 是否环境不一致？

三、如果你愿意，我可以更精确帮你

你可以补充：

• 使用什么技术（Maven / npm / pip / Gradle）
• 报错原文
• 是 编译 / 运行 / 测试 阶段缺失

我可以直接帮你定位到具体依赖和配置。