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-tw/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 或開發構建一致。
驗證與排障
預覽、登入和深連結在目標裝置上正常工作。