You need to enable JavaScript to run this app. 从WSL1切换至WSL2后Expo无法启动 连接拒绝类报错求助
优惠活动
大模型
产品
解决方案
定价
更多

从WSL1切换至WSL2后Expo无法启动 连接拒绝类报错求助

WSL2 环境下 Expo 启动 ECONNREFUSED 报错与 Watchman 超时解决方案

代理配置残留清理

报错中connect ECONNREFUSED 127.0.0.1:8888是典型的本地代理服务连接失败问题,WSL1环境下配置的全局代理会被WSL2继承,但WSL2内部未运行对应端口的代理服务,会导致所有出站请求(包括Expo账号校验、内部服务状态探测)全部失败。

  • 执行命令查看当前环境代理配置:
    env | grep -i proxy
  • 若存在指向127.0.0.1:8888的配置,临时清理执行以下命令:
    unset http_proxy
    unset https_proxy
    unset all_proxy
    unset HTTP_PROXY
    unset HTTPS_PROXY
    unset ALL_PROXY
    
  • 永久清理需要编辑~/.bashrc、~/.zshrc、/etc/environment文件,删除所有包含proxy、8888的配置行,执行source ~/.bashrc生效。
  • 清理完成后重新运行expo login,若报错消失即确认代理配置为根因之一。

WSL2 网络与端口绑定修复

WSL2采用独立NAT虚拟网络架构,与WSL1直接共享Windows网络栈的逻辑完全不同,Expo默认绑定127.0.0.1会导致:Windows侧浏览器无法访问localhost:19002开发者工具、局域网内设备无法连接Metro服务。

  • 执行命令获取WSL2的实际IP地址:
    ip addr show eth0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}'
  • 启动Expo时强制指定主机IP,避免默认localhost绑定:
    expo start --host 上述获取的WSL2 IP --port 19000
  • 若需要Windows侧直接通过localhost访问Expo服务,需在管理员权限的Windows PowerShell中配置端口转发:
    netsh interface portproxy add v4tov4 listenport=19000 listenaddress=0.0.0.0 connectport=19000 connectaddress=WSL2的IP地址
    netsh interface portproxy add v4tov4 listenport=19001 listenaddress=0.0.0.0 connectport=19001 connectaddress=WSL2的IP地址
    netsh interface portproxy add v4tov4 listenport=19002 listenaddress=0.0.0.0 connectport=19002 connectaddress=WSL2的IP地址
    
  • 注:WSL2重启后IP会自动变化,可通过Windows启动脚本自动更新端口转发规则,无需手动重复配置。

Watchman 爬取超时修复

  • 禁止将项目存放在/mnt/开头的Windows NTFS挂载路径下,需将项目移动到WSL2原生ext4路径(即~/目录下),跨文件系统的9P协议延迟是Watchman连接超时的核心原因。
  • 在项目根目录创建空的.watchmanconfig文件,执行命令重置Watchman缓存:
    watchman watch-del-all
  • 若Watchman服务异常,执行watchman shutdown-server后重新启动Expo,由程序自动重新初始化服务。

连通性验证

  • 服务启动后,先在WSL2内部执行curl http://127.0.0.1:19001/status,若返回正常JSON状态,说明Metro Bundler已正常运行。
  • 从Windows侧浏览器访问http://WSL2的IP:19002,确认开发者工具页面可正常打开。
  • 手机端连接与电脑同一局域网的WiFi,扫描Expo展示的二维码即可正常访问,无需关闭系统防火墙。

内容的提问来源于stack exchange,提问作者Thomas D Cat

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.25 00:24:02