You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

React Native项目在Android Studio模拟器启动失败,已启动Metro仍报错

React Native Android Studio模拟器启动失败解决方案

针对你遇到的「已启动Metro但Android Studio模拟器无法加载脚本,终端npx react-native run-android可正常运行」的问题,可尝试以下解决方案:

  • 修正模拟器调试服务器地址
    Android模拟器默认无法直接访问主机的localhost,需替换为模拟器专属环回地址10.0.2.2:

    1. 打开模拟器的开发者菜单(摇设备或按Ctrl+M/Cmd+M)
    2. 选择「Dev Settings」→「Debug server host & port for device」
    3. 输入10.0.2.2:8081,重启应用
  • 调整Android Studio运行配置
    Android Studio默认在android子目录下启动进程,需指定项目根目录让Metro定位资源:

    1. 打开「Run/Debug Configurations」
    2. 找到你的应用配置,切换到「Arguments」标签页
    3. 在「Program arguments」中添加--root ../..,保存后重新运行
  • 检查Metro端口与运行状态
    确认Metro服务未被占用或可被模拟器访问:

    • 查看8081端口占用情况:
      Mac/Linux:lsof -i :8081
      Windows:netstat -ano | findstr :8081
    • 若端口被占用,重启Metro并指定新端口:npx react-native start --port 8082,同时在模拟器Dev Settings中更新对应端口
  • 配置离线Bundle(临时兜底方案)
    生成本地bundle让应用离线加载:

    1. 若android/app/src/main/assets目录不存在,先创建:mkdir -p android/app/src/main/assets
    2. 执行bundle生成命令:
      npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/
      
    3. 在Android Studio中重新编译运行应用

内容的提问来源于stack exchange,提问作者AJDee

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.18 22:10:28