React Native执行npx react-native run-android时应用安装失败

尝试运行npx react-native run-android启动空白应用，Expo CLI和React Native CLI均失败，错误核心为Gradle守护进程无法启动，具体错误日志如下：

信息：JS服务器已在运行。
信息：正在启动模拟器...
信息：模拟器启动成功。
信息：正在安装应用...
正在启动Gradle守护进程，1个不兼容的守护进程无法复用，使用--status查看详情

失败：构建过程中出现异常。

* 错误原因：
无法启动守护进程。
该问题可能由守护进程配置错误导致，例如使用了无法识别的JVM选项。
请参考Gradle守护进程相关用户手册章节：https://docs.gradle.org/7.5.1/userguide/gradle_daemon.html
进程命令行：D:\JAVA\bin\java.exe -XX:MaxMetaspaceSize=512m -Xmx2048m -Dfile.encoding=windows-1252 -Duser.country=US -Duser.language=en -Duser.variant -cp C:\Users\Owner\.gradle\wrapper\dists\gradle-7.5.1-all\1ehga6e77gqps5uk2kc5kf1vc\gradle-7.5.1\lib\gradle-launcher-7.5.1.jar org.gradle.launcher.daemon.bootstrap.GradleDaemon 7.5.1
请查看以下进程输出了解更多信息：
-----------------------
VM初始化过程中发生错误
无法为2097152KB的对象堆预留足够空间

错误：应用安装失败。请确保已正确配置Android开发环境：https://reactnative.dev/docs/environment-setup.
错误：命令执行失败：gradlew.bat app:installDebug -PreactNativeDevServerPort=8081


at makeError (D:\ReactNativeCLITutorial\MyNewsletter\node_modules\@react-native-community\cli-platform-android\node_modules\execa\index.js:174:9)
    at D:\ReactNativeCLITutorial\MyNewsletter\node_modules\@react-native-community\cli-platform-android\node_modules\execa\index.js:278:16    
    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)
    at async runOnAllDevices (D:\ReactNativeCLITutorial\MyNewsletter\node_modules\@react-native-community\cli-platform-android\build\commands\runAndroid\runOnAllDevices.js:109:5)
    at async Command.handleAction (D:\ReactNativeCLITutorial\MyNewsletter\node_modules\@react-native-community\cli\build\index.js:142:9)   

解决方案 #

1. 降低Gradle JVM堆内存配置 #

• 打开项目根目录下的android/gradle.properties文件
• 找到org.gradle.jvmargs配置项，将原有的-Xmx2048m调整为更小的值，比如-Xmx1536m或-Xmx1024m，示例：

  org.gradle.jvmargs=-Xmx1536m -XX:MaxMetaspaceSize=512m -Dfile.encoding=UTF-8
  

• 保存文件后，重新执行npx react-native run-android

2. 释放系统内存 #

• 打开任务管理器，关闭浏览器、大型软件、其他IDE等占用大量内存的进程，给JVM留出足够的内存空间

3. 清理旧Gradle守护进程 #

• 进入项目的android目录，执行命令：

  gradlew --stop
  

• 停止所有运行中的Gradle守护进程后，重新启动构建

4. 检查系统物理内存 #

• 确保电脑物理内存至少有4GB以上，若内存不足，考虑添加内存条提升可用空间

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