블로그
재연결 후 빈 세션 화면 디버깅하기
빈 화면 보고의 대부분은 전체 세션 손실이 아닌 상태 동기화 타이밍 문제입니다. 이 가이드를 통해 빠르게 원인을 파악하고 해결할 수 있습니다.
게시일 태그: 시작 가이드 / troubleshooting / sessions
블로그
이 카테고리의 제품 및 엔지니어링 업데이트를 확인하세요.
카테고리 보기재연결 후 "빈 화면"이 나타나면 당황스럽지만, 대부분의 경우 복구가 가능합니다.
세션은 여전히 존재하고 런타임도 활성 상태인 경우가 많습니다.
1단계: 세션 확인
의도한 세션을 보고 있는지 확인합니다.
- 세션 목록을 열고,
- 프로젝트/경로를 확인하고,
- 다른 세션으로 전환했다가 다시 돌아와서 컨텍스트를 새로고침합니다.
2단계: 상태 강제 새로고침
수동 새로고침을 실행하고 캡처 동기화가 완료될 때까지 잠시 기다립니다.
백엔드 캡처 경로가 정상이라면 출력이 다시 표시됩니다.
3단계: Start 전에 런타임 확인
빈 출력이 반드시 활성 작업이 없다는 것을 의미하지는 않습니다.
Start를 다시 실행하기 전에 런타임 상태를 확인하여 중복 실행을 방지하세요.
4단계: 전송 상태 확인
콘텐츠가 여전히 표시되지 않는 경우:
- 연결 안정성을 검증하고,
- 앱 라이프사이클 전환(백그라운드/포그라운드)을 확인하고,
- 서버 측 캡처 및 이벤트 플로우를 점검합니다.
5단계: 컨텍스트와 함께 보고
문제를 보고할 때 다음 정보를 포함하세요:
- 연결 모드 (로컬 또는 Cloudflare),
- 앱이 백그라운드에서 복귀했는지 여부,
- 재연결 후 Start를 탭했는지 여부,
- 완료 알림 타이밍.
이 컨텍스트가 있으면 진단 시간이 크게 단축됩니다.
예방 루틴
일관된 재연결 절차를 사용하세요:
- 재연결,
- 새로고침,
- 세션 상태 확인,
- 의도적으로 계속하거나 시작.
이 루틴을 따르면 대부분의 빈 화면 혼란이 워크플로우 중단으로 이어지는 것을 방지할 수 있습니다.