AGP版本决定Gradle版本，如AGP 8.4.x需Gradle 8.6、AGP 8.7.x需Gradle 8.9、AGP 9.2需Gradle 8.13+；JDK须为17～21.0.3+，且Android Studio中Gradle JVM与Project SDK需手动设为同一JDK。
看 AGP 版本再定 Gradle 版本
Android 项目里，Gradle 版本不是你想选哪个就选哪个——它被 AGP（Android Gradle Plugin）死死绑定了。打开项目根目录的 build.gradle 或 build.gradle.kts，找到 plugins { id "com.android.application" version "8.4.2" } 这类声明，里面的版本号就是关键。
常见绑定关系如下（2026 年主流组合）：
-
AGP 8.4.x→ 必须用Gradle 8.6 -
AGP 8.7.x→ 最低要求Gradle 8.9 -
AGP 9.2（AS Panda 2 默认）→ 强制Gradle 8.13+
如果硬配错，Sync 时会直接报 Minimum supported Gradle version is 8.9. Current version is 8.6，不给你任何商量余地。
JDK 版本必须卡在支持区间内
Gradle 8.6 只认 JDK 17～21，但要注意：JDK 21.0.0～21.0.2 存在已知兼容性问题，gradle -v 可能报 Could not determine java version from '21.0.1'；JDK 22+ 和 JDK 8～16 则完全不支持。
验证方式很简单：
- 运行
java -version看输出是否含17.、18.、19.、20.或21.0.3+ - 确保
JAVA_HOME指向的是这个 JDK，而不是系统默认的旧版本 - Windows 上别用
C:\Program Files\Java\...这种带空格的路径，IDEA 有时会解析失败
选 -all.zip 而不是 -bin.zip
离线安装或团队统一环境时，必须用 gradle-8.6-all.zip。它包含 Wrapper 模板、文档、示例和全部依赖 JAR，而 -bin.zip 只有可执行文件，首次运行时仍会联网下载大量资源，导致 Android Studio 卡在 Downloading gradle-8.6-all.zip ——其实它是在替你下自己。
另外两个细节容易被忽略：
- 解压路径必须是纯英文、无空格、无中文，比如
C:\gradle\gradle-8.6是安全的，C:\我的工具\gradle会导致GRADLE_HOME解析异常 -
GRADLE_HOME设置后，记得把%GRADLE_HOME%\bin（Windows）或$GRADLE_HOME/bin（macOS/Linux）加进PATH，否则gradle -v找不到命令
IDE 中的 JVM 设置常被覆盖
即使本地 gradle -v 成功，Android Studio 仍可能用错 JDK——因为它默认读取自己的嵌入式 JBR（JetBrains Runtime），而不是你设的 JAVA_HOME。
必须手动检查并修正：
- File → Settings → Build → Build Tools → Gradle → Gradle JVM：选你装的 JDK 17（不是 JBR）
- 同时确认 Project SDK 也指向同一 JDK（File → Project Structure → Project → SDK Location）
- 如果用了
Gradle With Me插件，它会自动匹配gradle-wrapper.properties里的版本对应 JDK，但首次启用需重启 IDE 生效
最隐蔽的坑是：AGP 9.2 + Gradle 8.13 要求 JDK 17 的 java.security 配置里不能禁用 TLS 1.3，某些企业 JDK 安装包默认关了它，会导致构建时连不上 Maven 仓库，错误信息却只显示 Could not resolve com.android.tools.build:gradle，跟网络无关。
