이 글의 성격은 무엇인가요?
질문 / 문제 해결
내용을 설명해주세요
앱인토스 미니앱을 배포했는데, 테스트 스킴과 콘솔 QR 모두 흰 화면에
"잠시 문제가 생겼어요"만 뜨고 앱이 실행되지 않습니다.
■ 환경
- 워크스페이스 74721 / appName: some-time-left
- SDK 2.10.10 (@apps-in-toss/framework 2.10.10)
- react-native 0.72.6, react 18.2.0
- 최근 배포: 20260820-6 (deploymentId 01a01e80-819f-7214-aab9-75a2f15c0847)
- iOS, 토스 앱 최신
■ 증상
- intoss-private://some-time-left?_deploymentId=… → 흰 화면
- 콘솔 ‘테스트’ QR → 동일
- 6개 버전 모두 동일 (17:14 ~ 18:39)
■ 확인한 것
- ait build 정상 종료. 0 errors / 0 warnings.
[1/2] Built for RN 0.84.0 (1917 modules)
[2/2] Built for RN 0.72.6 (1944 modules) - .ait 아티팩트를 직접 열어 번들 4개(ios/android × 0.84.0/0.72.6)와
__appsInToss 전역(brandDisplayName, brandPrimaryColor, brandIcon,
navigationBar)이 들어간 것을 확인했습니다. - 압축 해제 기준 14.9MB (한도 100MB 이내).
- 진입점(_app.tsx)에 지연 require + try/catch + ErrorBoundary를 넣어
시작 오류를 화면에 출력하도록 했으나, 그 화면도 뜨지 않습니다. - “잠시 문제가 생겼어요” 문구가 저희 번들에도, @apps-in-toss/framework
에도, @toss/tds-react-native에도 없습니다.
→ 미니앱 JS가 실행되기 전에 네이티브 단계에서 실패하는 것으로 보입니다.
■ 시도해본 것 (모두 효과 없음)
- granite.config의 target을 '0.72.6’으로 고정 → 제거 (0.84 번들이
0.72 호환 변환을 받고 있어서 수정했고, 번들이 분리된 것은 확인) - ait migrate react-native-0-84-0 (react 19 / rn 0.84) 적용
→ 번들 출력이 바이트 단위로 동일하여 되돌림 - 재배포 6회
■ 질문
- 네이티브 단계에서 로드가 실패하는 원인을 콘솔 로그로 확인할 수 있을까요?
- 테스트 실행에 필요한 사전 조건(앱 정보 제출 상태 등) 중 빠진 것이 있을까요?
