React Native运行安卓项目报错：Pixel_2_API_30模拟器启动超时

无法在Android端启动项目：启动Android模拟器Pixel_2_API_30耗时过长。你可以尝试通过终端手动启动模拟器，执行命令：C:\Users\ASUS\AppData\Local\Android\Sdk/emulator/emulator @Pixel_2_API_30

• 模拟器资源分配不足：给模拟器分配的运行内存、CPU核心数过低，或者电脑同时运行了其他占资源的软件，导致模拟器冷启动耗时超过React Native CLI默认的1分钟启动超时阈值
• 模拟器相关文件损坏：emulator工具组件、API 30对应的系统镜像文件下载不完整或损坏，和当前环境存在兼容问题
• 残留进程锁死：之前关闭模拟器时没有彻底退出进程，后台残留的模拟器进程占用了实例锁或端口，导致新的启动请求卡住
• 硬件加速配置异常：Windows系统下Hyper-V和HAXM加速配置冲突，或者显卡硬件加速没有正常开启，模拟器启动时渲染卡顿
• 权限/路径问题：React Native CLI读取的Android SDK路径和实际路径不匹配，或者系统权限不足拦截了模拟器启动命令

• 第一步先拿日志定位具体问题：打开终端，执行带详细日志参数的启动命令，直接看启动过程卡在哪一步

  C:\Users\ASUS\AppData\Local\Android\Sdk/emulator/emulator @Pixel_2_API_30 -verbose
  

  日志里会明确提示是镜像损坏、加速未开启、端口占用还是其他问题，不用盲目试错。
• 清理残留进程：打开任务管理器，找到所有emulator.exe、qemu-system-x86_64.exe相关进程，全部结束任务后再重新尝试启动。
• 校验模拟器配置：
  1. 打开Android Studio的SDK Manager，在SDK Tools页确认已安装最新版Android Emulator、Android SDK Platform-Tools；Intel CPU确认安装Intel x86 Emulator Accelerator (HAXM installer)，AMD CPU确认在Windows功能里开启了Hyper-V、Windows Hypervisor Platform两个选项。
  2. 打开AVD Manager，找到Pixel_2_API_30模拟器点编辑，展开高级设置，把分配的内存调到至少2GB，CPU核心数设为2核及以上，图形渲染选项选Hardware - GLES 2.0，不要选软件渲染，软件渲染启动速度会慢数倍。
• 修复损坏镜像：如果日志提示系统镜像加载错误，回到SDK Manager的SDK Platform页，取消勾选Android 11.0（API 30）选项，点应用删除现有损坏镜像，之后重新勾选下载安装即可。
• 绕过超时检测：如果手动执行命令能正常启动模拟器，只是启动速度太慢触发超时，可以每次运行项目前先手动打开模拟器，等模拟器完全加载到桌面后再执行npx react-native run-android，就不会触发超时报错；如果要改默认超时时间，可以找到项目下node_modules/@react-native-community/cli-platform-android/build/commands/runAndroid/launchEmulator.js文件，把里面默认的60000毫秒超时值改到120000以上。
• 权限排查：右键点击终端选择「以管理员身份运行」，再执行启动命令，排除系统权限拦截导致的启动卡顿。

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