Android Studio 3.1.2突然无法解析远程导入依赖，可正常构建运行

阿华AIGC实验室

2026-5-26

解决Android Studio 3.1.2远程依赖导入未解析但可正常构建的问题

我之前也碰到过这种诡异到离谱的情况——明明依赖已经下载完成，项目能正常编译甚至跑起来，但IDE就是红着脸报“导入未解析”的错，还连累所有项目都中招，太闹心了！结合你已经做过的清理、Invalidate Caches、删除Gradle缓存这些操作，给你几个针对性的排查和修复方向：

检查离线模式是否误开启
有时候不小心碰了开关打开离线模式，IDE会拒绝去索引远程仓库的依赖元数据，哪怕本地缓存里已经有完整的依赖文件。你可以去File > Settings > Build, Execution, Deployment > Gradle里确认，Offline work选项一定不要勾选。
强制触发彻底的依赖同步与索引
除了常规的Invalidate Caches，你可以试试更硬核的同步方式：
1. 打开项目根目录的build.gradle，随便加个无关的空格或者换行，然后点击右上角的Sync Now按钮，让IDE重新识别依赖配置
2. 或者在Terminal里执行命令：
```
# Mac/Linux
./gradlew clean build --refresh-dependencies
# Windows
gradlew.bat clean build --refresh-dependencies
```
  这个命令会强制Gradle重新拉取所有依赖的元数据，同时触发IDE的全量索引更新。
彻底重置IDE的缓存与索引服务
之前的Invalidate Caches可能不够彻底，你可以再试一次：打开File > Invalidate Caches...，选择Invalidate and Restart，同时勾选Clear file system cache and local history，重启后耐心等待IDE完成全部索引（右下角会有进度提示），别中途打断操作。
排查仓库配置与网络环境
虽然项目能构建，但IDE的索引服务对仓库地址的解析逻辑可能和Gradle构建不一样。检查项目根目录build.gradle里的repositories块，确保google()、mavenCentral()这些仓库地址配置正确，没有拼写错误。另外可以试试切换到手机热点，排除公司网络代理、防火墙导致的IDE无法访问仓库元数据的问题。
调整Gradle插件版本（终极方案）
Android Studio 3.1.2对应的Gradle插件3.1.2确实存在一些已知的索引bug，你可以尝试把项目根目录build.gradle里的插件版本调整为同系列的稳定版，比如：
```
classpath 'com.android.tools.build:gradle:3.1.4'
```
同步项目后再观察索引是否恢复正常。