Android Studio Koala 2024.1.1 Gradle初始同步找不到metadata.bin文件

1. 核对Gradle版本兼容性 #

Android Studio Koala默认适配Gradle 8.7，打开项目根目录下的gradle/wrapper/gradle-wrapper.properties文件，确认distributionUrl指向正确版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip

若此前为旧版本，手动修改后同步项目。

2. 用离线模式触发缓存重建 #

• 打开Android Studio，进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 勾选「Offline work」，点击Apply后同步项目
• 同步成功后取消勾选「Offline work」，再次同步
  该操作会强制Gradle重新生成完整缓存结构，避免单个文件缺失。

3. 针对性清理Gradle版本缓存 #

无需删除整个caches文件夹，仅删除报错关联的8.7版本缓存：

• 打开文件管理器，定位到C:\Users\[MY_USER]\.gradle\caches\8.7
• 删除整个8.7文件夹，重启Android Studio后同步项目
  Gradle会重新下载并生成该版本的完整缓存，后续不会再出现单个文件缺失问题。

4. 检查.gradle文件夹权限 #

确认当前用户对.gradle文件夹拥有读写权限：

• 右键点击C:\Users\[MY_USER]\.gradle文件夹，选择「属性 > 安全」
• 检查当前用户的权限列表，若缺少「读取和写入」权限，点击「编辑」添加对应权限，应用后重启Android Studio。

5. 切换Gradle运行配置 #

• 进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle
• 将「Gradle JDK」切换为Android Studio Koala自带的JDK（如jdk17），或本地兼容的JDK17版本
• 同时将「Build and run using」「Run tests using」设置为「Gradle」，而非「Android Studio」，完成后同步项目。

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