리소스 로딩 8/21 정체 — 저속 회선에서 9번째 영상 수신 지연
마지막 업데이트 2026-11-19
강예준 아동 2회기 입장 화면이 "친구가 만날 준비를 하고 있어요! 8/21"에서 멈춘 것처럼 보였다. 다운로드가 멈추거나 실패한 것이 아니라, 약 1Mbps 회선에서 15.1MB 영상을 받는 데 약 115초가 필요했다. 아동은 최대 56초를 기다린 뒤 나갔다 들어오기를 반복했고, 들어올 때마다 9번째 파일을 처음부터 다시 받았다.
멈춘 것이 아니라 느렸다. 필요한 시간은 약 115초, 기다린 시간은 최대 56초
- 9번째 파일은
video_new_pingpong01_story_step01_low.mp4다. 기기가 저사양으로 판정돼 480p 버전(15.1MB)을 받았다. - 앞의 아바타 영상 8개는 파일 크기를 완료 간격으로 나누면 모두 약 0.13MB/s(약 1Mbps)였다. 같은 속도라면 9번째 파일에 약 115초가 걸린다.
- 1차 입장에서 9번째 파일을 받은 시간은 56초, 2차는 40초였다. 재입장하면 받던 데이터가 사라져 매번 처음부터 다시 받았다.
- 3차 입장 중 같은 방에 다른 연결이 들어와(
Duplicate connection detected) 소켓이 끊겼다.
수신 바이트 증가를 직접 기록한 로그는 없다. 이 결론은 아바타 파일 8개에서 잰 회선 속도를 9번째 파일 크기에 적용한 계산이다. LogRocket export에는 network 항목이 없어 해당 요청의 실제 수신량은 확인하지 못했다.
나갔다 들어오기를 세 번 반복했다
| 시각 (11/18 KST) | 내용 |
|---|---|
| 20:01:52 | 1차 입장. 수업 데이터 로드 후 리소스 21개 다운로드 시작 (Starting resource caching {count: 21}). 저사양 기기 판정 isLowPerformanceDevice: true |
| 20:01:55 ~ 20:02:30 | 아바타 영상 8개를 파일당 3.7~5.8초 만에 저장 → 화면 8/21 |
| 20:02:30 ~ 20:03:26 | 리소스 관련 로그 없이 56초 경과. 9번째 파일 수신 중 |
| 20:03:26 | 입장 전 화면(/main/guest)으로 이동 → 20:03:31 2차 입장. 아바타 8개는 저장돼 있어 바로 8/21. 9번째를 처음부터 다시 받음 |
| 20:04:12 | 40초 만에 다시 나감 → 20:04:26 3차 입장. Re-entry loop detected {reentryCountWithin5Min: 3} |
| 20:04:38 | 탭이 백그라운드로 감 (Tab became hidden) |
| 20:04:54 | Duplicate connection detected - disconnecting socket → 소켓 종료, 미디어 세션 정리 |
| 20:05:02 | Network alert triggered {level: critical, reasons: [socket]} |
기기는 Android 10, Chrome 158, 메모리 4GB, 8코어. 1차 입장 전 스피커 테스트와 권한 확인은 모두 정상이었다.
9번째 파일은 첫 수업 단계 영상이다
서버의 ResourceService.collectActivityResourceFileNames는 아바타 리소스를 먼저 넣고, 그다음 활동 단계 리소스를 넣는다. prod DynamoDB(ppi-lesson, ppi-activity2, ppi-resource)를 읽기 전용으로 조회해 같은 순서로 재구성했다. 아바타 8개와 수업 리소스 13개를 합쳐 21개로, 로그의 count: 21과 일치한다.
| # | 파일 | 480p 크기 | 원본 크기 |
|---|---|---|---|
| 1–8 | 아바타 avatar_pingpong01_{HR,HR02,WJ01,WJ02}_{talking,idle}_0.mp4 | 0.51–0.76MB | — |
| 9 | video_new_pingpong01_story_step01_low.mp4 | 15.1MB | 51.8MB |
| 10 | video_new_pingpong01_story_step02_low.mp4 | 8.7MB | 27.5MB |
| 11 | image_harang_self_01.jpg | 1.7MB | 1.7MB |
| 12 | video_new_pingpong01_bridge_02.mp4 | 3.0MB | 38.0MB |
| 13 | image_store_0.jpg | 2.5MB | 2.5MB |
| 14 | video_new_pingpong01_bridge_03_low.mp4 | 12.2MB | 35.5MB |
| 15–21 | 이미지 4개, bridge_04, bridge_05, epilogue | 합계 약 27MB | — |
저사양 기기는 /api/resources/urls에서 s3KeyProcessed480p가 있으면 480p를 받는다(apps/web/app/api/resources/urls/route.ts). 9번째 파일의 360p 버전은 7.5MB다.
9번째 파일 정보는 2026-06-01 이후 바뀌지 않았다. 다만 2회기 수업 레코드의 마지막 수정 시각이 세션 이후(20:21 KST)라서 당시 활동 구성이 지금과 같다고 확정하지는 못했다. 파일 개수가 21개로 같으므로 순서도 같았을 가능성이 높다.
아바타 8개가 모두 약 0.13MB/s로 받아졌다
| 파일 | 480p 크기 | 완료 간격 | 속도 |
|---|---|---|---|
| HR_talking (메타데이터 요청 포함) | 0.53MB | 3.68초 | 0.15MB/s |
| HR_idle | 0.51MB | 3.87초 | 0.13MB/s |
| HR02_talking | 0.76MB | 5.82초 | 0.13MB/s |
| HR02_idle | 0.65MB | 4.96초 | 0.13MB/s |
| WJ01_talking | 0.66MB | 5.13초 | 0.13MB/s |
| WJ01_idle | 0.62MB | 4.71초 | 0.13MB/s |
| WJ02_talking | 0.71MB | 5.38초 | 0.13MB/s |
| WJ02_idle | 0.67MB | 5.14초 | 0.13MB/s |
8개 파일의 속도가 거의 같으므로 회선 속도는 세션 내내 일정했던 것으로 본다. 이 속도로 9번째 파일(15.1MB)을 받으면 약 115초가 걸린다.
시도별로 받은 양 (추정)
막대 전체 길이 = 15.1MB (약 115초)
1차 · 56초 · 약 7MB (48%)
2차 · 40초 · 약 5MB (35%), 처음부터 다시 받음
3차 · 탭이 숨기 전 약 12초, 끊기기 전 약 28초
남은 12개까지 모두 받으려면 21개 전체에 약 8분이 필요한 상황이었다.
다른 설명도 검토했다
교차 검증(Codex)에서 "15초 무진행 경고가 없으니 바이트가 계속 들어왔다"는 추론만으로는 부족하다는 지적이 있었다. 같은 로그 공백을 만드는 다른 경로를 함께 따졌다.
| 설명 | 판단 | 근거 |
|---|---|---|
| 9번째 파일을 느리게 받는 중 | 유력 | 회선 속도 계산상 56초로는 다 받을 수 없다. 받는 동안에는 성공 로그도 진행률 증가도 없다. |
| 네트워크가 멈춤 (15초 이상 무진행) | 가능성 낮음 | fetchResumable은 15초 무진행 시 끊고 [FETCH_RESUMABLE] Fetch failed ... retrying 경고를 남긴다(apps/web/lib/fetch-resumable.ts:100, :232). 로거는 warn을 console.warn으로 내보내 LogRocket이 수집하며, 실제 export에 다른 WARN 10건이 있다. 그런데 이 경고가 없다. |
다운로드 완료 후 cache.put() 대기 | 배제 못 함 · 덜 유력 | 저장이 끝나야 성공 로그가 찍힌다. 다만 회선 속도상 56초 안에 다운로드가 끝날 수 없으므로, 저장 대기 단계까지 갔을 가능성은 낮다. |
| 브라우저·탭 정지 | 가능성 낮음 | 공백 중 20:02:54, 20:03:25에 rAF 프로브가 약 59fps를 기록했다. 이탈 시점에도 pageVisible: true였다. |
| 다운로드 실패 | 아님 | Guest:ResourceFetchFailed, Resource caching failed, blocking entry가 없다. |
구조적으로 드러난 문제
- 진행률이 파일 개수 기준이다.
onProgress(completed, total)는 파일 하나를 다 받고 저장해야 오른다(apps/web/hooks/use-resource-cache.ts:324). 15MB 파일을 받는 2분 동안 화면은 8/21에 그대로라 사용자는 멈춘 것으로 판단한다. - 받다 만 파일은 재입장하면 처음부터 받는다.
fetchResumable의 이어받기는 한 번 호출되는 동안 메모리에 쌓인 청크에만 적용된다. 페이지를 떠나면 사라진다. 이 사례에서 아동이 나갔다 들어올 때마다 진행분이 0이 됐다. - 전체 다운로드에 시간 제한이 없다.
use-lesson-data-loader.ts:242는cacheResources를signal·deadlineAt없이 호출한다. 회선이 느리면 실패 화면도 뜨지 않고 무기한 대기한다. - 저사양 판정은 기기 성능 기준이고 회선 속도는 반영하지 않는다. 이 기기는 480p를 받았지만, 0.13MB/s 회선에서는 480p 영상도 하나에 1~2분이 걸린다.
개선 방향과 추가 확인
개선 방향
- 진행률을 바이트 기준으로 표시 — 메타데이터 응답에 파일 크기를 담거나
Content-Length를 사용해, 큰 파일을 받는 동안에도 진행 바가 움직이게 한다. - 저속 회선이면 360p로 받기 — 앞선 파일에서 잰 속도가 기준보다 낮으면 이후 영상을 360p로 요청한다. 9번째 파일은 15.1MB에서 7.5MB로 줄어든다.
- 첫 단계 리소스만 먼저 받고 입장 — 나머지는 수업 중 백그라운드로 받는다.
- 진행 정체 시 안내 — 일정 시간 진행이 없으면 "인터넷이 느려요" 같은 안내를 띄워, 재입장으로 진행분을 날리지 않게 한다.
추가 확인
- 20:04:54 중복 연결의 주인 — 같은 시각 같은 roomId의 다른 LogRocket 세션과 socket 서버 로그를 확인해야 한다.
- LogRocket 재생의 Network 탭에서 S3
GET …_480p.mp4요청의 실제 지속 시간과 수신 크기를 확인하면 저속 전송을 직접 증명할 수 있다. - 바이트 단위 진행 로그와
cache.put시작·완료 로그를 추가하면 다음 사례에서 느린 전송과 저장 대기를 바로 구분할 수 있다.
근거 자료
- 사용자가 제공한 LogRocket 로그 export 1개(
logEntries151건, network 항목 없음)와 재생 화면 캡처 1장. 원본 JSON은 이 문서에 첨부하지 않았다. - prod DynamoDB
ppi-lesson-prod,ppi-activity2-prod,ppi-resource-prod읽기 전용 조회(2026-11-19). - 코드:
apps/web/hooks/use-resource-cache.ts,apps/web/lib/fetch-resumable.ts,apps/web/entities/guest-page-session/model/use-lesson-data-loader.ts,apps/web/lib/api/services/resource.service.ts,apps/web/app/api/resources/urls/route.ts. 현재 main 체크아웃(658debb9) 기준이며, 당시 배포 버전과의 일치는 확인하지 않았다.