执行Android应用时出现org.gradle.wrapper.GradleWrapperMain类未找到异常

修复步骤 #

• 检查gradle-wrapper.jar文件完整性
  进入项目根目录下的gradle/wrapper文件夹，确认是否存在gradle-wrapper.jar文件。如果缺失，可从正常的React Native项目中复制该文件到对应目录，或执行命令重新生成wrapper：

  gradle wrapper --gradle-version 你的项目指定Gradle版本（如7.5）
  

  版本号可查看gradle/wrapper/gradle-wrapper.properties内的distributionUrl字段，比如https\://services.gradle.org/distributions/gradle-7.5-all.zip对应的版本为7.5。

• 校验gradle-wrapper.properties配置
  打开gradle/wrapper/gradle-wrapper.properties，确认distributionUrl路径无拼写错误，且网络可正常访问该地址。若网络受限，可手动下载对应Gradle压缩包，将distributionUrl修改为本地路径，示例：

  distributionUrl=file\:///C:/gradle-7.5-all.zip
  

• 清理缓存并重建项目
  执行以下命令清理缓存：

  # 重置React Native缓存
  npx react-native start --reset-cache
  # 清理Android项目缓存
  cd android
  ./gradlew clean
  cd ..
  

  之后重新运行项目：

  npx react-native run-android
  

• 检查目录权限
  确保项目目录及gradle文件夹拥有足够读写权限，避免因权限不足导致无法读取wrapper文件。

• 替换损坏的gradlew脚本
  若gradlew或gradlew.bat脚本损坏，可从官方React Native模板中下载对应脚本替换，或通过gradle wrapper命令重新生成。

内容的提问来源于stack exchange，提问作者Lúcio Da cruz de Moraes