React Native安卓模拟器启动失败求助：未完全启动即退出

问题详情 #

运行npx react-native run-android时触发报错：

Failed to launch emulator. Reason: The emulator quit before it finished opening. You can try starting the emulator manually from the terminal with: emulator @INFO | Storing crashdata in: /tmp/android-mypc/emu-crash-34.1.18.db, detection is enabled for process: 21525

手动启动模拟器后问题仍未解决。

排查与解决步骤 #

1. 检查模拟器配置兼容性 #

• 打开Android Studio的AVD Manager，核对目标模拟器配置：
  • 确保系统镜像版本与本地Android SDK Build Tools版本匹配（如SDK Build Tools 34对应Android 14镜像）
  • ARM架构Mac（M1/M2/M3）必须选择ARM 64-v8a系统镜像，禁止使用x86_64镜像
  • 限制模拟器内存分配：RAM不超过物理内存的50%，比如16G内存的Mac，模拟器RAM设为4G以内

2. 用命令行启动并排查详细错误 #

• 先获取可用模拟器列表：

  emulator -list-avds
  

• 指定模拟器并开启 verbose 模式启动，查看完整报错日志：

  emulator @你的模拟器名称 -verbose
  

  从输出中定位核心错误，比如显卡驱动冲突、权限缺失等

3. 修复macOS权限问题 #

• 对于ARM Mac：
  1. 打开系统设置 > 隐私与安全性 > 安全性
  2. 若看到"emulator"被系统阻止的提示，点击"允许"，重启终端后重试
• 修复模拟器目录权限：

  sudo chmod -R 755 ~/Library/Android/sdk/emulator
  

4. 更新或重置Android Emulator #

• 打开Android Studio的SDK Manager，切换到SDK Tools标签，确保Android Emulator为最新版本，点击"Apply"完成更新
• 若更新无效，删除现有故障模拟器，重新创建：
  1. 在AVD Manager中删除问题模拟器
  2. 选择官方推荐设备（如Pixel 7），下载对应ARM镜像，重新生成AVD

5. 临时禁用硬件加速排查 #

• 若怀疑显卡驱动导致崩溃，尝试关闭硬件加速启动模拟器：

  emulator @你的模拟器名称 -no-accel -no-snapshot-load
  

  若能正常启动，说明硬件加速存在问题，可尝试更新Mac系统到最新版本（Intel Mac可更新显卡驱动）

6. 清理崩溃缓存文件 #

• 删除报错中提到的崩溃数据库：

  rm /tmp/android-mypc/emu-crash-34.1.18.db
  

  之后重新启动模拟器

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