启动React Native项目时无法访问Expo开发工具（localhost:19002）的问题

问题背景 #

通过以下步骤创建React Native项目：

npm install --global expo-cli
expo init my-first-react-native-app --template expo-template-blank@sdk-44 --npm

执行expo start启动Metro Bundler后，可正常访问http://localhost:19000/查看项目配置JSON，但无法访问http://localhost:19002/打开Expo开发工具，页面提示“无法访问此网站，localhost拒绝连接”。

可能的原因及解决方法 #

• 端口19002被占用
  其他程序可能占用了19002端口，导致Expo开发工具无法绑定该端口。可通过命令排查：

  • Windows系统：

    netstat -ano | findstr :19002
    

  • macOS/Linux系统：

    lsof -i :19002
    

  找到占用进程后关闭对应程序，再重新执行expo start。

• Expo CLI与SDK版本不兼容
  SDK 44对Expo CLI版本有特定要求，若当前CLI版本不匹配，可能导致服务启动异常。建议安装SDK44兼容的CLI版本：

  npm install --global expo-cli@^5.0.0
  

  更新完成后，清理项目缓存并重启服务：

  expo start --clear
  

• Metro Bundler服务启动不完整
  缓存或临时文件可能导致服务未完全初始化。可按以下步骤重置：

  1. 按Ctrl+C终止当前Metro服务
  2. 删除项目根目录下的.expo文件夹
  3. 执行expo start --clear重新启动服务

• 防火墙/安全软件拦截
  本地防火墙、杀毒软件可能拦截了19002端口的网络请求。临时关闭相关安全软件后尝试访问，若恢复正常，需将Expo相关进程添加到安全软件的白名单中。

• localhost解析异常
  部分环境下localhost解析可能存在问题，尝试直接使用http://127.0.0.1:19002/访问。同时检查本地hosts文件，确保127.0.0.1 localhost的映射配置正确。

内容的提问来源于stack exchange，提问作者oscarnei