回退Gradle和AGP版本需同步修改gradle-wrapper.properties中的distributionUrl与项目build.gradle中AGP的classpath版本，二者必须兼容，否则报错；推荐使用-bin.zip、注意URL转义、镜像源路径一致、手动下载后不解压放入~/.gradle/wrapper/dists/对应目录，并清理.project/.gradle缓存、关闭离线模式、核对JDK版本及Android Studio最低AGP要求。
直接改 gradle-wrapper.properties 就行，但必须配对 AGP 版本
Gradle Wrapper 本身只是个“下载器”，它不决定构建逻辑，只负责拉取指定版本的 Gradle 运行时。回退本质就是两步：改 Wrapper 配置 + 改 Android Gradle 插件（AGP）版本。缺一不可，否则会报 No signature of method: build_...android() 或 Incompatible version 这类错误。
gradle-wrapper.properties 里改 distributionUrl 的坑
常见错误是只改了 URL 却忽略发行版类型和网络可达性：
-
-all.zip包含源码和文档，体积大、下载慢；-bin.zip只含运行时，推荐日常使用（如gradle-7.5-bin.zip） - URL 中的反斜杠
\是必需转义符，漏掉会导致解析失败，例如写成https://.../gradle-6.3-bin.zip（少\）会静默失效 - 国内访问
services.gradle.org常超时，可临时换镜像源（如清华源），但注意路径要一致：https://mirrors.tuna.tsinghua.edu.cn/gradle/distributions/gradle-6.3-bin.zip - 手动下载 zip 包后，不要解压，直接丢进
~/.gradle/wrapper/dists/gradle-6.3-bin/xxxxxx/目录下（xxxxxx是校验哈希，Android Studio 自动生成）
AGP 版本必须和 Gradle 版本兼容
AGP 不是随便降的，比如你选了 gradle-6.5-bin.zip，那 AGP 最高只能用 4.1.3；若硬塞 7.0.0，Sync 时会直接报错 The project is using an incompatible version...。查兼容表最稳的方式是翻官方文档，但实践中可记几个关键锚点：
- Gradle 6.5 → AGP 4.1.x（最高
4.1.3） - Gradle 7.5 → AGP 7.4.x（最高
7.4.2） - Gradle 8.0 → AGP 8.0.x（最低要求 JDK 17）
修改位置在项目根目录的 build.gradle（Groovy）或 build.gradle.kts（Kotlin）里的 classpath 行，例如：
classpath "com.android.tools.build:gradle:4.1.3"
同步后仍报 Could not install Gradle distribution
这通常不是版本问题，而是环境卡在中间态：
- 删掉项目下的
.gradle文件夹（非用户家目录那个），避免缓存干扰 - 检查 Android Studio 设置里是否启用了离线模式（
Settings > Build > Gradle > Offline work），开着就关掉 - 确认 JDK 版本匹配：Gradle 6.x 用 JDK 8–11，7.x 起建议 JDK 11，8.x 强制 JDK 17；可在
File > Project Structure > SDK Location里核对 - 如果用的是新版 Android Studio（如 Otter 2025.2），它默认禁用旧 AGP（如低于 4.0），此时必须降级 Studio 或换兼容的 AGP，不能只调 Wrapper
真正容易被忽略的是：AGP 和 Gradle Wrapper 的版本绑定是单向强约束，但 Android Studio 自身也有最低 AGP 要求——这个限制藏在 IDE 启动日志和 About 对话框里，不报错时根本看不到。
