Android Studio Gradle同步失败：找不到setDependencyCacheDir方法求助

这个错误我之前踩过坑，大概率是Gradle插件与Android Gradle Plugin（AGP）版本不匹配或者本地缓存损坏导致的，给你几个实测有效的解决步骤：

1. 对齐Gradle与AGP版本 #

先打开项目根目录的build.gradle（Project级别的配置文件），检查com.android.tools.build:gradle的版本，确保它和你本地Gradle版本兼容：

• 比如AGP 7.0+需要搭配Gradle 7.0及以上；AGP 8.0+对应Gradle 8.0+
• 更省事的方式是打开Android Studio的File > Project Structure > Project，直接在面板里调整版本，IDE会自动帮你同步兼容的Gradle包

2. 彻底清理Gradle缓存 #

缓存损坏是这类问题的常见诱因，按以下步骤操作：

• 先关闭Android Studio
• 删除本地全局Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • Mac/Linux：~/.gradle/caches
• 回到项目，删除根目录下的.gradle和所有模块里的build文件夹
• 重新打开IDE，点击顶部工具栏的Sync Project with Gradle Files按钮

3. 强制刷新依赖 #

如果清理缓存后还是不行，试试强制刷新依赖链：

• 在Android Studio右上角的Gradle面板里，点击「Refresh all Gradle projects」图标
• 或者在终端执行命令：
  Mac/Linux：./gradlew clean build --refresh-dependencies
  Windows：gradlew clean build --refresh-dependencies

4. 检查仓库配置 #

确认根目录build.gradle里的仓库配置正确，保证能拉到官方依赖：

repositories {
    google()
    mavenCentral()
}

如果是国内网络环境导致依赖拉取不完整，可以临时切换国内镜像仓库，但同步完成后建议改回官方仓库，避免后续版本兼容问题。

要是以上步骤都没解决，你可以把项目根目录和模块级的build.gradle代码贴出来，方便进一步排查版本适配问题。

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