求助：Metro Bundler无法连接Android模拟器问题

一、确认模拟器基本可用性 #

• 手动启动模拟器：打开Android Studio的AVD Manager，选中目标模拟器点击Launch，确认能正常进入系统界面。
• 验证adb连接状态：在终端执行adb devices，查看输出是否包含模拟器设备（格式一般为emulator-xxxx device）。若未显示，重启adb服务：

  adb kill-server
  adb start-server
  

二、检查环境变量与项目配置 #

• 确认ANDROID_HOME环境变量配置正确：
  • Windows：在系统环境变量中添加ANDROID_HOME，值为Android SDK安装路径（例如C:\Users\<用户名>\AppData\Local\Android\Sdk）
  • macOS/Linux：在~/.bashrc或~/.zshrc中添加：

    export ANDROID_HOME=$HOME/Library/Android/sdk
    export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator
    

    执行source ~/.bashrc（或对应shell配置文件）使配置生效。
• 检查项目android/local.properties文件：确保文件中sdk.dir路径与你的Android SDK路径一致，若文件不存在，手动创建并添加：

  sdk.dir=<你的Android SDK完整路径>
  

三、修复Metro Bundler连接异常 #

• 手动启动Metro后再构建：在项目根目录执行npx react-native start，待Metro加载完成后，新开终端执行npx react-native run-android。
• 清除Metro缓存：执行npx react-native start --reset-cache清理缓存后，重新尝试构建。
• 手动配置端口反向代理：在终端执行adb reverse tcp:8081 tcp:8081，确保模拟器能访问本地Metro服务。

四、排查兼容性问题 #

• 确认模拟器系统版本：使用API 26及以上的Android系统镜像（React Native对低版本API支持有限）。
• 更新SDK工具：打开Android Studio的SDK Manager，将SDK Platform Tools、Android Emulator更新至最新版本。

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