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

Expo Go扫描二维码后无法连接React Native项目的问题求助

Expo Go 扫码启动React Native项目的网络类报错解决方法

按实际踩坑优先级整理的可落地排查步骤,基本能覆盖这类连接失败的常见诱因:

  • 第一优先级核对网络环境一致性:手机和运行项目的开发电脑必须处在同一可互通的局域网下,高频踩坑点包括手机默认走移动数据、两边连同一个Wi-Fi但网络开启了AP隔离、连的是访客网段做了设备互访限制,先把手机移动数据彻底关闭,确认两边Wi-Fi完全匹配后再重新扫码测试。
  • 排查软件层面的端口拦截:macOS/Windows自带防火墙、各类第三方安全软件,经常会默认拦截Node.js进程的局域网入站请求,临时关闭防火墙后如果能正常加载,就给Node.js进程加局域网入站放行规则,别把Expo服务默认占用的8081端口给拦截了。
  • 遇到网络隔离直接切换隧道启动模式:如果确认当前Wi-Fi做了设备间互访限制没法直连,就不用反复折腾局域网配置了,直接执行隧道启动命令expo start --tunnel,等服务完成公网隧道转发后,扫新生成的二维码启动,这个模式不依赖局域网互通,哪怕手机和电脑不在同一个Wi-Fi也能正常拉取项目资源。
  • 最后做版本兼容性校验:如果网络配置全对还是报连接错误,就检查当前项目的Expo SDK版本和手机端Expo Go的应用版本是否匹配,跨大版本的SDK是没法被对应版本的Expo Go正常识别拉取的,版本不匹配就调整项目SDK版本,或者安装对应版本的Expo Go客户端再试。

补充小技巧:所有配置都核对完还是报错的话,就彻底关掉本地启动的Expo服务,清掉项目缓存后再重新启动,本地缓存损坏也会触发看起来像网络问题的伪报错。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 13:45:04