게스트측 네트워크 이슈 5주 분류
복구 로직 현황과 개선 방안

마지막 업데이트 2026-11-02

대상 기간: 2026-09-28 ~ 11-01 (5주)분석: 2026-11-02코드 변경 없음

1. 결론

"게스트 네트워크 불안정" 경고에는 네트워크와 무관한 오탐이 대량으로 섞여 있다. 이를 빼면 실제 네트워크 신호는 회기의 39.9%, 수업이 실제로 끊긴 연결 단절은 8.6%다.
8,087회기 (아동 1,737명)
39.9%실제 네트워크 신호
8.6%연결 단절
70~90%끊김 중 2~3초 내 자동 복구

데이터: S3 prod/lesson-logs 게스트 세션로그 538,026파트. 회기 = (아동, 회차, KST 날짜), 페이지 로드 = 파일명의 instanceId.

2. 5주 분류 결과 (회기 기준)

한 회기가 여러 유형에 해당할 수 있다. 노란 행은 네트워크와 무관한 오탐이다.

유형회기비율
X1 진입 직후 카메라 미확보로 "인터넷이 끊겼어요" 경고1,64220.3%
X2 진입 직후 서버 응답 지연 (guest-step-update ack 미도달)4,63757.3%
X3 대역폭 추정치만 낮음 (RTT·손실 정상)1,10613.7%
A 연결 단절 (소켓·송신·AI 음성 끊김)6988.6%
E 가정 인터넷 전체 다운 (외부·서버 모두 실패)2563.2%
B 회선 품질 저하 (RTT ≥400ms 또는 손실 ≥5%)1,76721.8%
D 수업 중 송신 정체1,65620.5%
F 우리 서버만 실패 (외부 정상)2843.5%

새로고침이 있었던 1,162회기 중 46%는 실제 네트워크 신호가 없었다. CX 리포트의 "고객 측 92%"는 X1 오탐이 섞인 경고 기준이라 근거로 쓰기 어렵다.

X2·D는 후속 분석에서 송신 정체가 아니라 서버 ack 무응답으로 재해석했다(527건 문서).

3. 자동 복구 현황

층현재 동작5주 복구율한계
소켓 (socketSfu.ts)재연결 5회, 3~10초 간격69% · 중앙 2.0초5회 실패 후 복구 없음
영상 송신 (use-mediasoup-producer.ts)transport 재생성 최대 3회92% · 중앙 3.0초3회 실패 시 새로고침 안내
AI 음성 (livekit-client-session.ts)SDK 기본 재연결68% · 중앙 2.4초완전히 끊기면 AI 세션 재시작 없음
영상 수신 (use-mediasoup-consumer.ts)transport not found일 때만 재생성—끊김 상태 변화에는 복구 없음

재진입까지 간 실제 끊김 273회기의 근거는 가정 회선 42% · 우리 서버 13% · 근거 없음 45%다. 복구 실패가 곧 가정 회선 탓은 아니다.

4. 우리 쪽 결함 2건

진입 직후 오탐 경고 (회기 20.3%)

페이지 진입 → 카메라·마이크 스트림 아직 null
  → 끊김으로 판정   use-guest-network-alert.ts:168
  → 7초 후 "인터넷이 끊겼어요" + 진행자 화면에 critical 경고
  → 스트림 획득 후 해소

카메라 critical 경고의 88%가 진입 15초 이내였다.

활동 전환마다 송신 연결 재생성 (회기 19%)

활동 전환 → AI 세션용 마이크 교체
  → 송신 연결 초기화 effect 재실행 → 기존 transport close
  → Failed to produce mic audio: AwaitQueueStoppedError   use-mediasoup-producer.ts:881
  → 0.3~1.5초 뒤 재생성

진행자 쪽에서 아이 영상·음성이 매번 잠깐 끊긴다. effect를 다시 실행시키는 의존값은 특정하지 못했다(후보: socket.connected·joinGeneration·rtpCapabilities).

5. 진행자 기록 대조

진행자 노트 원문 기준 527건 대조는 527건 문서에 있다.

6. 개선 우선순위

  1. 진입 직후 오탐 제거: 스트림 미획득은 끊김에서 제외, 입장 확인 전 ack 미판정 (use-guest-network-alert.ts:168)
  2. 활동 전환 송신 연결 재생성 수정 (use-mediasoup-producer.ts 초기화 effect)
  3. 순단 자동 복구 강화: 끊김 안내를 새로고침 대신 제자리 재연결로, 소켓 재시도 상한 제거, 수신 경로 복구 추가, AI 세션 자동 재시작
  4. 회선 불량 시 품질 하향: 카메라 일시 중지·음성 우선
  5. 서버 경로 조사: 같은 시각 여러 아동의 서버 실패 대조, TCP·TURN(443) 폴백 확인

가정 회선 자체는 우리가 고칠 수 없다. 목표는 끊김을 없애는 게 아니라 짧은 끊김을 사람 개입 없이 복구하는 것이다.

7. 한계