React Native iOS 모달 겹침으로 화면 터치가 먹통일 때 — 거절된 모달이 남긴 투명한 막을 찾아 고친 기록
목차
1. 증상: 홈 목록만 얼었고, 헤더와 기록 바는 눌렸습니다
2026년 10월 12일, 데일리베이비 리뉴얼 작업 중 로컬 QA 환경의 iOS 시뮬레이터로 화면을 캡처하다가 홈 목록이 터치를 받지 않는 것을 발견했습니다. 새 계정으로 첫 아기를 등록하고 [시작하기]를 누르면 홈 목록이 스크롤도 탭도 받지 않았고, 탭 바도 눌리지 않았습니다. 그런데 위쪽 헤더와 하단 기록 바는 멀쩡히 반응했습니다. 기록이 하나도 없는 아기로 로그인해도 홈 목록이 같은 식으로 멈췄습니다. 앱을 완전히 껐다 켜야 풀렸고, Android에서는 일어나지 않았습니다.
이런 부분 먹통은 오해하기 쉽습니다. 헤더가 반응하니 JS 스레드는 살아 있고, 목록만 안 움직이니 스크롤뷰와 제스처 핸들러의 충돌이나 터치 응답자(responder)를 누가 잡고 놓지 않는 문제부터 떠오릅니다. 화면에는 아무것도 떠 있지 않았고, 에러 화면도 크래시도 없었습니다.
사실 이 버그는 전에 한 번 모습을 비쳤습니다. 리뉴얼 첫 단계에서 Maestro 자동화 UI 테스트 흐름 하나가 네 번 실패했는데, 그때는 "새로 설치한 첫 홈에서 추천 코드 시트가 첫 사용 안내 뒤로 사라진다"는 버그로 기록했습니다. 출시 버전에서도 그렇게 동작한다는 이유로 다음 단계로 넘겼고, 테스트 데이터를 바꿔 그 경로를 비켜 갔습니다. "시트가 안 뜬다" 뒤에 "화면이 멈춘다"가 숨어 있었다는 것을 안 것이 이날이었습니다.
2. 진단: 로그 한 줄과 hitTest 한 번
먼저 재현 조건을 좁혔습니다. 평소 쓰던 QA 계정으로는 멈출 때도 있고 아닐 때도 있었지만, 기록이 하나도 없는 아기가 있는 계정이나 아기 등록부터 시작하는 계정에서는 매번 멈췄습니다. 둘 다 첫 실행 조건이고, 첫 실행에는 첫 사용 안내, 추천 코드 입력 시트, 첫 기록 축하라는 시트 세 개가 몇 초 사이로 뜰 수 있습니다.
시뮬레이터 앱의 시스템 로그는 simctl로 흘려 볼 수 있습니다. 앱 프로세스로 걸러 놓고 재현하자 이런 줄이 찍혔습니다(객체 주소 같은 부분은 줄였습니다).
xcrun simctl spawn booted log stream --predicate 'process == "DailyBaby"' | grep "Attempt to present"Attempt to present <RCTFabricModalHostViewController…> … which is already presenting …UIKit의 경고입니다. 이미 모달을 띄우고 있는 뷰 컨트롤러에 또 띄우라고 하면, UIKit은 요청을 받아들이지 않고 이 한 줄만 남깁니다. 예외도 크래시도 아니어서 로그를 일부러 보지 않으면 모릅니다. 클래스 이름에 Fabric이 들어 있듯 당시 앱은 React Native 0.81.5(Expo SDK 54)의 새 아키텍처로 돌았고, 첫 실행 시트들은 react-native-modal 13으로 그리고 있었습니다.
로그는 무언가가 거절됐다는 것까지만 알려 줍니다. 목록의 터치를 가져가는 것이 정말 그 모달인지 확인하려고, 실행 중인 앱에 lldb를 붙여 멈춘 목록 위 좌표(x, y)로 UIKit 히트 테스트를 직접 돌렸습니다. 그 점을 터치하면 어떤 뷰가 이벤트를 받는지 알려 주는 호출입니다.
lldb -p <앱 PID>(lldb) expr -l objc -O -- (id)[[(id)[(id)[UIApplication sharedApplication] keyWindow] hitTest:(CGPoint){x,y} withEvent:nil] description]돌아온 것은 목록의 셀이 아니라 React Native 모달의 호스트 뷰인 RCTModalHostViewComponentView였습니다. 이 뷰의 내부 플래그 _isPresented는 1인데, 띄워졌다면 값이 있어야 할 presentingViewController는 nil이었습니다. 띄웠다고 기록됐지만 아무도 띄우지 않은 모달이 투명한 전체 화면 뷰로 목록 위에 남아 있었던 것입니다.
3. 원인: UIKit은 거절했고, React Native는 띄운 것으로 기록했습니다
iOS에서 모달은 한 번에 하나만 올라갑니다. 이번에 확인한 바로는 다른 모달이 화면에 있을 때뿐 아니라 아직 닫히는 중일 때 들어온 표시 요청도 거절됐습니다. 문제는 React Native 쪽 기록이었습니다. 표시가 거절돼도 RCTModalHostViewComponentView는 자신을 '표시됨'으로 두고, JS에서도 그 시트는 여전히 visible입니다. 보이지 않는 시트는 닫을 방법이 없으니 상태는 그대로 남고, 투명한 호스트 뷰가 그 아래 터치를 모두 가져갑니다. 앱을 다시 켜야만 풀린 이유입니다.
멈추는 범위가 달랐던 것도 같은 원리입니다. 추천 코드 시트는 홈 화면 안에, 첫 사용 안내와 첫 기록 축하는 탭 레이아웃에 놓여 있었습니다. 첫 사용 안내가 떠 있는 동안 추천 코드 시트가 거절됐을 때는 홈 목록이 멈췄습니다. 새 가족의 첫 홈에서는 반대로 추천 코드 시트 뒤에서 첫 사용 안내가 거절됐고, 목록과 탭 바가 함께 멈췄습니다. 거절된 모달이 놓인 자리에 따라 막히는 범위가 달라진 셈입니다.
세 시트가 부딪힌 이유는 코드에 그대로 있었습니다.
| 시트 | 놓인 곳 | 띄우는 시점 | 수정 전에 기다리던 것 |
|---|---|---|---|
| 첫 사용 안내 | 탭 레이아웃 | 기록 0건인 아기가 보이고 0.5초 뒤 | 없음(setTimeout) |
| 추천 코드 시트 | 홈 화면 | 홈에 들어오고 1.5초 뒤, 한 번 | 시스템 창, 기록 시트 |
| 첫 기록 축하 | 탭 레이아웃 | 첫 기록 저장 1초 뒤 | 없음(setTimeout) |
추천 코드 시트는 10월 초 v2.10 작업에서 만든 useActivePrompt 훅으로 띄웠습니다. 앱이 active일 때만 띄우는 훅이고, 주석에는 알림 권한 같은 시스템 창 아래에 모달을 띄우면 iOS에서 화면이 반응하지 않을 수 있다고까지 적혀 있었습니다. 그런데도 추천 코드 시트가 기다리는 다른 시트는 기록 시트 하나뿐이었고, 나머지 둘은 setTimeout으로 시간만 재고 떴습니다. 셋이 비슷한 때에 뜨려 하면 먼저 올라간 하나를 빼고는 거절될 수밖에 없었습니다.
구멍이 하나 더 있었습니다. 앱에는 광고나 리뷰 요청이 시트 위에 겹치지 않도록 열린 시트를 세는 카운터(isBlockingSheetOpen())가 이미 있었는데, 시트를 visible이 true인 동안만 셌습니다. [건너뛰기]를 누르면 visible은 바로 false가 되지만, 시트는 닫힘 애니메이션과 iOS의 네이티브 해제를 거치며 약 0.4초 더 화면에 남습니다. 카운터는 그동안 열린 시트가 없다고 답했고, 그 틈에 들어온 표시 요청은 실제로 거절됐습니다. 처음 적어 둔 고칠 방향은 추천 코드 시트가 이 카운터도 기다리게 하는 것이었지만, 그것만으로는 이 0.4초가 그대로 남습니다.
원리를 알고 나니 반년 전 버그도 다시 보였습니다. 2026년 4월(RN 0.79.5)에 초대 코드 화면에서 모달을 닫는 순간 다음 모달을 열거나 홈으로 이동하던 흐름이 터치를 잃어, 그 다음 동작을 onModalHide로 미루는 식으로 고친 적이 있습니다(커밋 d3c0461). 그때 적은 원인은 "backdrop이 고아 상태로 남아 터치를 차단"이었습니다. 증상에 가까운 이름이었고, 그래서 반년 뒤 비슷한 증상을 곧바로 연결 짓지 못했습니다.
4. 수정: 시트는 화면을 완전히 떠날 때까지 열려 있는 것으로 셉니다
원칙은 한 줄입니다. 시트는 visible이 된 순간부터 화면에서 실제로 사라질 때까지 열린 것으로 셉니다. 이것을 useBlockingModal이라는 작은 훅으로 만들었습니다.
// utils/blockingModal.ts (d642a8b, 설명 주석은 생략)
export function useBlockingModal(visible: boolean): { onDismiss?: () => void; onModalHide?: () => void } {
const [onScreen, setOnScreen] = useState(visible);
useEffect(() => {
if (visible) setOnScreen(true);
}, [visible]);
useBlockingSheet(visible || onScreen);
const gone = useCallback(() => setOnScreen(false), []);
return Platform.OS === "ios" ? { onDismiss: gone } : { onModalHide: gone };
}visible이 false가 돼도 onScreen은 모달이 정말 사라졌다는 신호가 올 때까지 true로 남고, 카운터는 visible || onScreen을 셉니다. iOS에서는 그 신호를 RN Modal의 onDismiss로 받습니다. 네이티브 해제가 끝난 뒤 불리므로 닫힘 애니메이션까지 모두 기다리게 됩니다. 다른 플랫폼에서는 react-native-modal이 모달을 완전히 숨긴 뒤 부르는 onModalHide를 씁니다. 훅이 돌려준 props를 <Modal>에 펼쳐 넣으면 끝입니다. 추천 코드 시트, 첫 사용 안내, 첫 기록 축하, 그리고 같은 카운터를 쓰던 추적 허용 사전 안내(ATT)를 이 훅으로 옮겼습니다.
다음은 기다리게 하는 일입니다. 첫 사용 안내와 첫 기록 축하를 setTimeout에서 useActivePrompt로 옮기고, 세 시트 모두 기록 시트와 다른 열린 시트가 없을 때까지 기다리게 했습니다.
// app/(app)/(tabs)/_layout.tsx (d642a8b)
const isOtherSheetOpen = useCallback(() => useUIStore.getState().recordModalVisible || isBlockingSheetOpen(), []);
useActivePrompt(celebrationDue, () => setShowCelebration(true), 1000, isOtherSheetOpen);
// app/(app)/(tabs)/index.tsx (d642a8b) — 추천 코드 시트
useActivePrompt(
!!currentBaby && !hasSeenReferralPrompt && canApplyCode && !pendingReferralCode,
() => setShowReferralPrompt(true),
1500,
() => useUIStore.getState().recordModalVisible || isBlockingSheetOpen(),
);useActivePrompt는 지연 뒤 차단 조건을 확인하고, 막혀 있으면 같은 간격으로 다시 시도합니다. 막혔다가 풀리면 600ms를 더 기다려 앞 모달이 물러날 시간을 주고, 앱이 inactive면 active로 돌아올 때 다시 예약합니다. 이제 세 시트는 앞 시트가 화면에서 완전히 사라진 뒤에야 표시를 요청합니다.
앱 전체에서 쓰는 확인 시트 호스트(ConfirmHost)는 이 수정 전부터 차례 대신 실패를 감지하는 방식으로 대비하고 있었습니다. 루트 모달을 띄우고 900ms(SHOW_WATCHDOG_MS) 안에 onShow가 오지 않으면 거절된 것으로 보고, 요청을 큐에서 빼 모달을 내린 뒤 같은 질문을 네이티브 Alert로 다시 묻습니다. Alert는 맨 위 화면에 뜨므로 다른 모달이 있어도 보입니다.
// components/ui/ConfirmSheet.tsx — 루트 모달이 실제로 떴는지 지켜보는 부분
useEffect(() => {
if (nested) return undefined;
shown.current = false;
const timer = setTimeout(() => {
if (!shown.current) presentFailed(id);
}, SHOW_WATCHDOG_MS);
return () => clearTimeout(timer);
}, [id, nested]);5. 검증과 반영, 그리고 남은 것
같은 QA 환경 시뮬레이터에서 수정 전에 멈추던 세 경우(새 가족의 첫 홈, 기록 없는 아기로 로그인, 첫 기록 축하)가 모두 통과했고, 어느 로그에도 "Attempt to present"가 남지 않았습니다. 회귀 테스트 tests/first-run-modals.test.cjs는 실제 소스(blockingModal, blockingSheet, useActivePrompt, 홈 화면, 탭 레이아웃)를 스토어 대역과 Node의 가짜 타이머 위에서 돌려 시간 순서를 재현하는 13건입니다. 출시 코드에서는 6건이 실패하고, 수정 뒤에는 모두 통과합니다. 프로젝트 관문 검사에서도 타입 검사 새 오류 0건, 린트 오류 0건, Node 테스트 1,724건 통과를 확인했습니다.
home: the referral sheet waits while the first-use guide is up and while it is still leaving the screen
tabs: the guide waits while another sheet is up or still leaving the screen
tabs: the celebration waits for the referral sheet (first record saved from the dock right after the guide)사용자에게 보이는 변화도 있습니다. 새 가족도 이제 첫 사용 안내 다음에 추천 코드 시트를 실제로 봅니다. 첫 사용 안내는 알림 권한 창 아래가 아니라 그 창이 닫힌 뒤에 뜨고, 광고·리뷰 요청·추적 허용 안내는 이 시트들이 닫힌 뒤 약 0.4초를 더 기다립니다. 다른 시트가 없을 때의 타이밍은 그대로입니다.
이 수정은 2026년 10월 12일 리뉴얼 브랜치에 커밋 d642a8b로 들어갔고, 늦어도 10월 31일 출시한 2.14.0부터 사용자에게 반영됐습니다. 다음 날 만든 새 기능 소개 시트와 첫 홈 코치마크도 같은 규칙을 따릅니다.
남은 것도 있습니다. 공용 Sheet 컴포넌트와 선택 업데이트 창은 지금도 visible인 동안만 셉니다. 이 둘까지 옮기면 전면 광고 게이트가 '다른 시트가 열려 있음'으로 보는 시간도 길어지기 때문에, 따로 판단할 문제로 남겨 두었습니다.
이번 버그는 Supabase Realtime이 조용히 끊기던 문제처럼 실패가 어디에서도 크게 드러나지 않았습니다. UIKit은 경고 한 줄만 남겼고, React Native는 표시됨으로 기록했고, JS는 visible을 믿었습니다. 퀵바 성능 문제의 "기록이 두 개 생겨요"처럼, "시트가 사라진다"도 더 큰 문제의 그림자였습니다.
6. 같은 증상을 만나면 확인할 것
iOS에서만 화면 일부가 터치를 잃는다면 다음 순서로 확인해 보시기 바랍니다.
- 반응하는 곳이 남아 있는지 봅니다. 다른 버튼이 눌린다면 JS 스레드는 살아 있으니, 제스처 충돌보다 보이지 않는 뷰가 덮고 있는지부터 의심합니다.
- 시스템 로그에서
Attempt to present를 찾습니다. 시뮬레이터는simctl로그 스트림, 실기기는 Xcode 콘솔에서 볼 수 있습니다. - 멈춘 좌표로 hitTest를 돌립니다.
RCTModalHostViewComponentView가 나오면 거절된 모달이 남긴 막일 가능성이 큽니다. - 그 순간 떠 있었거나 닫히는 중이던 모달을 모두 적습니다. 권한 요청 같은 시스템 창도 넣습니다.
- '열려 있다'를
visible로 판단하지 않습니다. iOS는onDismiss, 그 밖에는onModalHide까지 셉니다. - 타이머로 띄우는 모달은 앱이 active이고 다른 시트가 모두 사라진 뒤에 띄웁니다.
onShow가 일정 시간 안에 오지 않으면 거절로 보고, 모달을 내린 뒤 네이티브 Alert 같은 다른 경로로 넘깁니다.- 재현은 첫 실행 조건을 갖춘 계정으로 합니다. 평소 쓰던 계정으로는 들쭉날쭉했습니다.
- 가짜 타이머로 시간 순서를 고정한 테스트를 남깁니다. 0.4초짜리 틈은 손으로 다시 확인하기 가장 어렵습니다.