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 /ko/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
모바일 앱 문제 해결
흔한 미리보기, 구성, 네이티브 빌드 실패를 테스터에게 도달하기 전에 해결합니다.
설치 및 설정
앱이 백엔드에 접근하지 못한다면 휴대폰의 localhost는 휴대폰 자신을 뜻합니다. 컴퓨터의 LAN 주소, 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 또는 개발 빌드와 맞추세요.
검증 및 문제 해결
미리보기, 로그인, 딥링크가 대상 기기에서 동작합니다.