> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 移动应用故障排除

在问题到达测试人员之前，修复常见的预览、配置和原生构建故障。

## 安装与配置

如果应用无法访问后端，请记住手机上的 `localhost` 指的是手机本身。使用电脑的局域网地址、Android 模拟器的 `10.0.2.2`，或 HTTPS 预发布 URL。先在手机浏览器中打开该地址；在改代码前检查 Wi-Fi、防火墙和 VPN。Expo 隧道传输的是界面包，不是你的 API。

`EXPO_PUBLIC_API_URL` 缺失或错误会在登录前显示为配置错误。回调被拒绝通常意味着构建中的方案与服务器的 `MOBILE_ALLOWED_ORIGINS` 不一致，或者回调在 Expo Go 而非原生构建中运行。


## 实现流程

更改原生依赖或方案后，停止 Metro、清除缓存、重新构建开发客户端并重新安装应用。如果只改了 JavaScript，重新加载预览即可。保持应用的 Expo SDK 版本与设备上安装的 Expo Go 或开发构建一致。


## 验证与排障

预览、登录和深链接在目标设备上正常工作。


## 下一篇

[桌面端概览](https://supastack.dev/zh/docs/desktop.md)