expo go 应用在真机上出现 “network request failed” 错误，而 web 端正常，根本原因通常是 api 地址使用了 `localhost` 或 `127.0.0.1`，导致移动端无法访问本机服务；需改用局域网 ip 并确保后端允许跨设备请求。
在 Expo 开发中，localhost 是一个仅对开发机器自身有效的回环地址。当你在浏览器中运行 Expo Web 时，请求由同一台电脑的浏览器发起，http://localhost:3000 可以正常解析并通信；但当你使用 Expo Go 在 Android/iOS 真机上运行应用时，手机和开发机是两个独立设备——此时 localhost 指向的是手机自身的回环接口（即手机本身），而非你的后端服务所在机器，因此必然触发网络错误。
✅ 正确做法是：将 BASE_URL 中的 localhost 替换为开发机在局域网中的真实 IPv4 地址（例如 http://192.168.1.15:5000），并确保后端服务已配置为监听所有网络接口（而非仅 127.0.0.1）。
? 第一步：获取开发机的局域网 IP 地址
-
macOS / Linux：终端执行
ipconfig getifaddr en0 # Wi-Fi 接口（常见） # 或使用更通用的命令： hostname -I | awk '{print $1}' -
Windows：命令提示符中运行
ipconfig | findstr "IPv4"
找到类似 IPv4 地址 . . . . . . . . . . . : 192.168.1.15 的条目，取该 IP。
⚠️ 注意：不要使用 127.0.0.1、localhost、0.0.0.0 或公网 IP（如阿里云/腾讯云服务器地址），必须是与手机处于同一 Wi-Fi 网络下的本机局域网 IP。
? 第二步：配置后端服务监听所有接口
以常见后端为例（Node.js/Express）：
// ❌ 错误：只监听 localhost（手机无法访问） app.listen(5000, 'localhost'); // ✅ 正确：监听所有网络接口（0.0.0.0 表示通配） app.listen(5000, '0.0.0.0'); // 或省略 host 参数（默认等价于 0.0.0.0） app.listen(5000);
同时确认防火墙未拦截该端口（如 macOS 防火墙、Windows Defender 高级安全设置）。
? 第三步：更新 Expo 项目中的 BASE_URL
修改 fetchData.js 中的定义：
// ❌ 错误（仅适用于 Web 和本机调试） const BASE_URL = 'http://localhost:5000'; // ✅ 正确（替换为你的实际局域网 IP） const BASE_URL = 'http://192.168.1.15:5000'; // ← 替换为你查到的 IP！
? 提示：为便于多环境切换，可借助 .env 文件管理（需配合 expo install expo-constants 或 dotenv 客户端方案），但注意 Expo Go 不支持原生 dotenv，推荐使用 Constants.manifest?.extra 或构建时注入。
? 常见补充排查项
- ✅ 手机与开发机在同一 Wi-Fi 下（关闭手机蜂窝数据，确认 Wi-Fi 名称一致）
- ✅ 后端服务已启动且端口开放（手机浏览器访问 http://192.168.1.15:5000/login 应能返回响应或 404，而非超时）
- ✅ 禁用 HTTPS 强制跳转（Expo Go 默认不信任自签名证书；若后端强制 HTTPS，请临时关闭，或使用 ngrok 提供可信隧道）
- ✅ 检查 CORS 配置（虽不影响请求发出，但若后端未正确设置 Access-Control-Allow-Origin，fetch 可能静默失败；建议后端添加）：
app.use((req, res, next) => { res.header('Access-Control-Allow-Origin', '*'); // 开发期可设为 * res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE'); res.header('Access-Control-Allow-Headers', 'Content-Type, Authorization'); next(); });
✅ 验证成功标志
- 手机浏览器访问 http://[你的IP]:5000/login → 返回 JSON 或 405 Method Not Allowed（说明网络连通）
- Expo Go 应用点击登录 → 控制台不再报 Network request failed，而是收到预期响应或业务错误
⚠️ 注意：fetch 报错 "Network request failed" 几乎 100% 指向连接层失败（DNS 解析失败、TCP 连接被拒、超时），与 CORS、JSON 解析、HTTP 状态码无关——请优先聚焦网络可达性。
通过以上步骤，你的 Expo Go 应用即可稳定调用本地开发 API。记住核心原则：localhost ≠ 你的开发机 IP，真机必须用真实局域网地址通信。
