Expo Go 中 API 请求失败的完整解决方案：本地开发服务器地址配置指南

Expo Go 中 API 请求失败的完整解决方案：本地开发服务器地址配置指南第1张

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();
});