一、Maven/Gradle 依赖下载失败（提示 “Could not resolve dependency”）
- 解决办法：
- 配置国内镜像源：Maven 在settings.xml中添加阿里云镜像；Gradle 在build.gradle中配置maven { url ‘https://maven.aliyun.com/repository/public’ }。
- 清理本地仓库缓存：删除 Maven 的~/.m2/repository或 Gradle 的~/.gradle/caches中对应依赖目录，重新下载。
- 检查依赖坐标：确认groupId、artifactId、version是否正确（参考 Maven 中央仓库）。
- 关闭代理或 VPN：避免网络拦截，确保能访问仓库地址。
- 手动安装本地依赖：mvn install:install-file -Dfile=xxx.jar -DgroupId=xxx -DartifactId=xxx -Dversion=xxx -Dpackaging=jar。
二、依赖版本冲突（提示 “Multiple bindings for dependency”）
- 解决办法：
- Maven 使用mvn dependency:tree查看依赖树，找到冲突版本。
- 排除冲突依赖：在pom.xml中用<exclusions>标签排除低版本或不兼容版本。
- 强制指定版本：Maven 通过<dependencyManagement>统一版本；Gradle 用force关键字。
- 使用工具分析：IDEA 安装 “Maven Helper” 插件，可视化展示冲突并一键排除。
三、构建命令执行失败（如mvn clean install提示 “BUILD FAILURE”）
- 解决办法：
- 查看错误日志：定位具体失败原因（如编译错误、测试用例失败）。
- 跳过测试阶段：mvn clean install -DskipTests（避免测试用例报错阻塞构建）。
- 检查pom.xml/build.gradle语法：确保 XML/ Groovy 配置无语法错误（如标签未闭合）。
- 升级构建工具版本：Maven/Gradle 版本过低可能不支持新语法，更新至最新稳定版。
四、本地仓库路径错误（依赖下载后仍提示 “找不到”）
- 解决办法：
- 检查 Maven/Gradle 仓库配置：Maven 的settings.xml中localRepository是否指向正确路径（默认~/.m2/repository）。
- 修复仓库权限：Linux/macOS 执行chmod -R 755 ~/.m2/repository，确保有读取权限。
- 重新初始化仓库：删除异常仓库目录，让构建工具重新创建并下载依赖。
五、第三方私有依赖无法获取（提示 “Not authorized to access repository”）
- 解决办法：
- 配置私有仓库凭证：Maven 在settings.xml的<servers>中添加账号密码；Gradle 在gradle.properties中配置credentials。
- 检查仓库 URL：确保私有仓库地址正确（如公司内部 Nexus 仓库地址）。
- 临时禁用私有仓库：注释pom.xml/build.gradle中的私有仓库配置，优先使用公共仓库（仅限测试）。