Gradle依赖已解析但IDE标记未解析不可用问题排查求助

• 检查Nexus构件完整性

  • 登录Nexus确认目标构件的pom文件、业务jar包（或对应格式文件）是否齐全，maven-publish上传时可能出现只传pom没传本体的情况，尤其是上传配置有误的时候。
  • 核实当前认证账号对该构件的读取权限，哪怕是公开仓库，也要检查仓库的访问控制列表，有没有误加了IP限制或账号权限拦截。

• 验证Gradle仓库配置细节

  • 核对build.gradle/settings.gradle里的仓库认证信息：username、password有没有拼写错误，密码里的特殊字符（比如@、$）有没有转义问题，可临时把账号密码写死在配置里测试，排除环境变量读取失败的可能。
  • 确认仓库URL是否准确，有没有漏写仓库路径（比如https://xxx/repository/my-hosted-repo/这种格式，别漏了/repository/xxx/部分）。用curl命令直接测试下载：curl -u 账号:密码 构件的完整下载URL，看能否正常获取文件，排除网络或底层认证问题。

• 清理Gradle本地缓存

  • 删除本地Gradle缓存目录中对应构件的缓存，路径一般是~/.gradle/caches/modules-2/files-2.1/[groupId]/[artifactId]；或者执行命令./gradlew clean build --no-build-cache --refresh-dependencies强制刷新所有依赖，避免缓存脏数据干扰。
  • 检查是否开启了Gradle离线模式，IDE或命令行里如果勾选了Offline选项，会直接用本地缓存，不会去远程仓库拉取新构件。

• 核对依赖坐标一致性

  • 确认项目中依赖的groupId、artifactId、version和Nexus里的完全一致，注意大小写（Linux环境下的Nexus存储路径是大小写敏感的，哪怕Gradle不区分，也可能导致找不到文件）。
  • 如果构件带classifier（比如xxx-test.jar这种），检查项目依赖里有没有指定对应的classifier属性，否则会默认找无classifier的主构件，导致匹配失败。

• 排查Nexus仓库配置

  • 确认目标仓库是hosted类型（不是proxy代理仓库），如果是proxy仓库，检查代理的目标地址是否正确；如果是仓库组，确认目标仓库已经加入到组中且未被禁用。
  • 查看Nexus仓库的状态，有没有被设置为只读或禁用，这种状态下无法读取构件。

• 查看Nexus访问日志

  • 登录Nexus后台，查看仓库的访问请求日志，看Gradle请求构件时的HTTP状态码：401是认证失败，404是文件不存在，403是权限不足，这些能直接定位问题根源。日志可在Nexus安装目录的sonatype-work/nexus3/log/request.log查看，或后台UI的System -> Logs入口查找。

内容的提问来源于stack exchange，提问作者GreatDev