首次运行React Native项目报错：gradlew.bat执行失败（退出码1）

错误信息 #

错误：应用安装失败。命令执行失败，退出码1：gradlew.bat app:installDebug -PreactNativeDevServerPort=8081
FAILURE: 构建过程出现异常。

• 问题原因：无法确定任务':app:compileDebugJavaWithJavac'的依赖项。> 无法确定null的依赖项。> java.io.IOException: 文件名、目录名或卷标语法不正确
• 建议操作：> 使用--stacktrace选项获取堆栈跟踪。> 使用--info或--debug选项获取更多日志输出。> 使用--scan选项获取完整分析信息。> 访问https://help.gradle.org获取更多帮助。
  BUILD FAILED in 6s。

解决方案 #

• 检查项目路径：确保项目存放路径无中文、空格或特殊符号，改用纯英文路径，例如D:\RN_Projects\MyFirstApp。
• 清理Gradle缓存：删除项目根目录下的.gradle文件夹，以及android/app/build文件夹，重新执行npx react-native run-android。
• 验证JAVA_HOME配置：确认JAVA_HOME环境变量指向JDK根目录，路径无特殊字符，且配置生效。
• 通过Android Studio同步Gradle：导入项目的android文件夹到Android Studio，等待Gradle同步完成后再尝试运行项目。

内容的提问来源于stack exchange，提问作者Ashirwad Kumar