从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
相关产品推荐
相关产品推荐

