Linux环境下Expo启动异常：白屏报错与扫码超时求助

1. 排查网络与端口占用 #

• 确认本地网络可正常访问外部服务，直接访问expo.dev验证连通性
• 检查Expo默认端口（19000-19006）是否被占用，执行命令：

  lsof -i :19000
  

  若有进程占用，杀死对应进程后重启Expo：

  kill -9 <PID>
  

2. 手动指定Expo绑定IP #

Linux环境下Expo可能无法自动识别局域网IP，启动时强制绑定所有网卡：

expo start --host 0.0.0.0

启动后查看终端显示的局域网IP，确保手机与电脑处于同一WiFi网络，扫描该IP对应的二维码。

3. 调整防火墙规则 #

• 临时关闭防火墙测试：

  sudo ufw disable
  

  若问题解决，重新开启防火墙并添加端口例外：

  sudo ufw enable
  sudo ufw allow 19000:19006/tcp
  sudo ufw allow 19000:19006/udp
  

4. 清除Expo缓存 #

缓存损坏可能引发异常，执行命令清除缓存后重启：

expo r -c

5. 调整expo-cli版本 #

5.6.0版本可能存在兼容性问题，尝试降级到稳定版或升级到最新版：

npm uninstall -g expo-cli
# 降级到5.4.12稳定版
npm install -g expo-cli@5.4.12
# 或升级到最新版
npm install -g expo-cli@latest

6. 检查手机代理设置 #

若手机开启了网络代理，会阻断与本地Expo服务的连接，关闭代理后再尝试扫码。

内容的提问来源于stack exchange，提问作者Taboka Fanuel Sialumba