For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
移动应用故障排除
在问题到达测试人员之前，修复常见的预览、配置和原生构建故障。
安装与配置
如果应用无法访问后端，请记住手机上的 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 或开发构建一致。
验证与排障
预览、登录和深链接在目标设备上正常工作。