Android项目Gradle同步失败，无法解析依赖问题求助

排查步骤与解决方法 #

• 检查IDE离线模式状态
  打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle，确认Offline work未被勾选。若开启离线模式，IDE会无法拉取远程依赖，而命令行默认不会启用该模式。
• 重置IDE的Gradle配置文件
  删除项目根目录下.idea文件夹中的gradle.xml文件和libraries子文件夹，重启Android Studio后重新执行同步操作。这些文件存储了IDE本地的依赖缓存配置，可能因长期未使用出现损坏。
• 统一IDE与命令行的Gradle环境
  1. 在File > Settings > Build, Execution, Deployment > Build Tools > Gradle中，选择Use local Gradle distribution，路径指向你命令行构建成功时使用的Gradle 7.4安装目录。
  2. 在项目根目录的gradle.properties中添加如下配置，确保JDK版本与命令行一致（Gradle 7.4推荐使用JDK 11）：

     org.gradle.java.home=/path/to/your/jdk11
     

• 清理IDE的深层缓存目录
  除了常规的File > Invalidate Caches...操作，手动删除Android Studio的缓存目录：
  • Windows：C:\Users\<你的用户名>\.AndroidStudio2021.3\system\caches
  • macOS：~/Library/Caches/Google/AndroidStudio2021.3
    删除后重启IDE再尝试同步。
• 重新导入项目
  关闭Android Studio，删除项目根目录的.idea和.gradle文件夹，然后通过File > New > Import Project重新导入项目，让IDE重新生成所有配置文件。

关键分析 #

命令行构建成功说明依赖声明、仓库配置均无问题，故障点集中在Android Studio的本地配置或缓存损坏上，以上操作均针对IDE层面的异常配置进行修复。

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