新建Android Studio项目报gradle-wrapper.properties加载错误如何解决？

报错信息：Could not load wrapper properties from 'xxx\gradle\wrapper\gradle-wrapper.properties'

1 修改新项目全局默认配置（核心修复） #

你之前单次修改单项目Gradle版本不生效，是因为修改的是当前项目配置，没有改全局新项目默认规则，按以下路径调整：

• 打开Android Studio，进入File > New Projects Setup > Settings for New Projects
• 定位到Build, Execution, Deployment > Build Tools > Gradle菜单
• 二选一配置即可：
  • 优先选本地Gradle模式：Use Gradle from选择Specified location，路径选择你本地已验证可正常运行的Gradle解压目录，同时Gradle JDK选择匹配的JDK版本（建议选JDK11或JDK17），以后所有新项目默认调用本地Gradle，不需要下载wrapper
  • 若要保留wrapper模式：直接调整Gradle JDK为你单项目正常运行时用的JDK版本，保存即可

2 修复默认项目模板的wrapper配置 #

如果修改全局配置后仍有问题，是Android Studio内置的新建项目模板的wrapper配置损坏导致：

• 打开Android Studio安装目录，进入plugins\android\lib\templates\gradle\wrapper\gradle\wrapper路径
• 打开路径下的gradle-wrapper.properties文件
• 将distributionUrl参数修改为你已验证可正常使用的Gradle版本对应的下载地址，保存文件后所有新建项目都会自动沿用该配置

3 清理无效缓存 #

• 关闭所有Android Studio窗口，进入用户目录下的.gradle文件夹，删除caches、wrapper两个文件夹的全部内容
• 进入C:\Users\你的用户名\.AndroidStudio<对应版本号>目录，删除caches文件夹的全部内容
• 重启Android Studio即可生效

内容的提问来源于stack exchange，提问作者Shanjth.R