장애 조사 · 발생일 2026-11-13 · 분석일 2026-11-16 · 모든 로그 시각은 KST

iPhone 아바타 미노출과 흰 화면 조사

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

13회기 고객 영상과 아동·모니터 브라우저 로그를 대조한 중간 조사 기록이다. 코드 수정과 실기기 재현은 수행하지 않았다.

조사 중 · 원인 미확정

캐릭터 표시 이상은 확인됐지만 기기 귀책은 확정되지 않았다

고객 영상에서 캐릭터가 사라지는 동안 아동 카메라는 계속 움직인다. 18:48:53 신고 스냅샷에서는 앞쪽 두 video 요소의 currentSrc가 빈 상태이며 readyState: 0으로 기록됐다. 캐릭터 영상의 소스 선택·로딩·해제·표시 경로가 우선 조사 대상이다.

수업 자료 사전 캐시는 세 번 모두 failedCount: 0이다. 제공된 기록에는 다운로드 실패, video.play() 거절, 미디어 error 이벤트가 없다. 그러나 캐릭터 파일별 다운로드 완료 기록과 재생 실패 로그가 충분하지 않아 S3 파일 로딩 문제까지 배제할 수는 없다.

아이폰 고장, 성능 부족, 서버 무관, 다운로드 실패 중 어느 하나를 원인으로 확정하지 않는다. S3에 저장된 이 파일은 브라우저 로그이며 백엔드 서버 로그나 S3 접근 로그가 아니다.

검토 자료와 범위

자료범위한계
LogRocket JSON 2개2,000건: 18:23:05~18:31:48
17,000건: 18:32:19~18:46:16
수업 후반 기록이 없어 이후 제공된 S3 보관 로그로 보완했다. 두 자료를 합산해 오류 건수를 세지 않았다.
S3 보관 JSONL37,564줄. guest 18,266건, monitor 19,298건.
전체 18:26:25~18:52:31, guest는 18:30:00~18:52:30.
.gz 확장자지만 제공된 파일 내용은 압축이 해제된 평문 JSONL이다. data의 JSON 문자열을 파싱해 분석했다.
고객 촬영 영상 3개약 22초, 13초, 17초. 시간별 프레임을 추출해 시각적으로 검토했다.음성 내용은 판정하지 않았다. 영상 내 절대 시각이 없어 로그와 초 단위로 동기화하지 못했다.
리소스 등록 스크린샷현재 화면에서 talking과 idle이 각각 1개다.11월 13일 당시에도 동일한 등록 상태였는지, 실제 파일 바이트가 정상인지 확인한 자료는 아니다.
PPI 소스 정적 검토분석 기준 리비전 c0400d5f23f227774c4971d17295ab4967c45787사고 당시 배포된 브라우저 번들과 이 리비전의 동일성은 별도 확인이 필요하다.

고객 영상에서는 캐릭터 영역이 비어 있다

파일관찰해석
talkv_high.mp4
22.167초
추출한 0~22초 프레임에서 수업 콘텐츠 영역이 흰색으로 비어 있다. 아동 카메라의 얼굴과 말하기 테두리는 변한다.화면 전체 정지보다 캐릭터 표시 경로의 이상과 맞는다. 브라우저가 모든 기능을 정상 처리했다는 뜻은 아니다.
talkv_high (1).mp4
12.917초
교실 비교 자료와 아동 카메라는 보이지만 오른쪽 위 캐릭터 영역이 비어 있다.자료가 고정된 모습 자체는 영상 정지의 증거가 아니다. 관련 활동 로그에는 split:image 대화 단계가 있다.
talkv_high (2).mp4
16.792초
농구 자료 옆 캐릭터가 초반에 없고 약 6초 프레임에는 나타난다. 약 16.7초 프레임에는 다시 사라진다. 아동 카메라는 계속 변한다.대화 중 아바타 표시가 불안정한 정황이다. 농구 배경은 로그의 '수호고민상담' 이미지 단계와 맞는다. 캐릭터 소멸이 발화 전환 때문인지는 확정하지 않았다.

원본 고객 영상과 얼굴 이미지는 이 문서에 첨부하지 않았다. 원본 파일명은 근거 자료 대조용이다.

로그에서 확인한 시간순 사건

시각관찰원본 줄
18:30:01.932getUserMedia가 NotAllowedError로 한 번 실패했다. 재입장 후 18:30:18.108과 18:32:27.542에는 카메라·마이크 시작이 성공했다.별도 LOCAL_MEDIA_STREAM 이벤트
18:30:01.088 / 18:30:16.252 / 18:32:26.132세 입장의 수업 자료 캐시 결과가 모두 failedCount: 0이다.84 / 279 / 3030
18:30:55.603 / 18:31:12.417 / 18:31:56.342'친구가 안 보여요' 신고 3회. 첫 video는 srcKind: none, readyState: 0이다.872 / 1193 / 2801
18:32:12.801reason: kick으로 강제퇴장 이벤트가 기록됐다. 이 이벤트만으로 브라우저 종료나 자연 연결 단절로 해석하지 않는다.2922
18:39:24.507'친구가 안 보여요' 신고. 첫 video는 none / 0, 두 번째는 blob / 4이며 정지 상태다.13080
18:48:42.025활동 10, 스텝 0 '동아리선택'으로 전환했다. full:ai, 초기 상태 idle이다.30664 / 30666
18:48:42.094해당 활동의 avatarId가 tiki_C02reward로 기록됐다. 18:48:42.122에는 hasAvatar: true다.30713 / 30716
18:48:53.178'친구가 안 보여요' 신고. 앞쪽 두 video 모두 none / 0 / paused다. aiSessionActive: true, 탭은 visible이다.31133
18:48:53.254모니터가 같은 신고를 수신했다. 신고 이벤트 전달 간격은 로그 시각 기준 76ms다.31135 / 31136
18:52:25.000엔딩송은 Blob URL이며 전체 길이 약 49.9초가 버퍼에 있다. readyState: 4로 재생을 시작했다.37485
18:52:30.316~18:52:30.376엔딩송이 4.498초에서 예상치 못하게 정지했다. 약 60ms 뒤 play와 복구 로그가 기록됐다. 이 짧은 복구 기록으로 앞선 지속적인 흰 화면을 설명할 수는 없다.37548~37551

18:48:53 스냅샷의 두 video는 선택된 소스가 없다

실제 메시지명은 [ISSUE_DIAG] Issue diagnostics snapshot at report다. currentSrc: ""라는 필드를 직접 출력한 로그는 아니다. 아래는 원본 31133줄에서 처음 두 요소의 관련 필드만 발췌한 내용이다.

videoSrc가 비었다고 직접 기록된 로그도 아니다. 이 스냅샷에는 React의 videoSrc 값이 없다. guest 로그에서 최상위 data에 videoSrc가 기록된 레코드를 별도로 확인했으며, 빈 문자열이나 null인 기록은 없었다. 이후 설명의 '소스 없음'은 srcKind: none에서 해석한 currentSrc 상태를 뜻한다.

{
	"issueText": "친구가 안 보여요",
	"media": [
		{ "srcKind": "none", "readyState": 0, "paused": true },
		{ "srcKind": "none", "readyState": 0, "paused": true }
	]
}

스냅샷은 DOM 순서대로 미디어 요소를 수집한다. 요소 ID, data-monitor-media, 파일명, src 속성은 기록하지 않는다. 아래 역할 대응은 현재 화면 구조와 비교한 추정이다.

요소 순서srcKindreadyStatepausedcurrentTime역할 해석
1none0true0아바타 idle 영상으로 추정
2none0true0아바타 talking 영상으로 추정
3src4false8.586콘텐츠가 없을 때 유지되는 기본 video로 추정
4srcObject4false982.701아동 카메라로 추정

srcKind: none은 진단 코드에서 srcObject가 없고 currentSrc가 빈 값이라는 뜻이다. src 속성 자체가 없었다는 확정 증거는 아니다. 다운로드를 완료했어도 소스 연결 누락, 전환 중 초기화, 소스 선택 이전 상태에서 이 값이 나올 수 있다.

반대로 카메라처럼 srcObject를 사용하는 요소는 이 진단에서 srcKind: srcObject로 구분한다. 해당 요소의 URL 상태를 파일 기반 video와 같은 기준으로 판단하지 않는다.

hasAvatar: true도 아바타 정보 조회 결과이며, idle·talking 영상 파일 다운로드 완료나 디코딩 성공을 뜻하지 않는다. 개별 video 리소스 ID와 파일명을 이 스냅샷에 직접 연결할 수 없다.

현재 리소스 등록 구성은 코드의 요구와 맞는다

useAvatarVideo는 두 타입의 resources[].fileName을 선택한다. 각각 1개인 구성도 허용된다. 스크린샷에서 등록 누락이나 타입명 오타는 보이지 않는다. 화면 썸네일만으로 MP4 파일의 정상 디코딩, 수업 당시 등록 상태, 아동 기기의 로딩 완료를 확인할 수는 없다.

아바타 정보 조회idle·talking 파일 선택
URL 발급과 파일 확보서버 API, 캐시 또는 S3 다운로드
Blob URL 연결video 소스 설정과 브라우저 소스 선택
재생과 표시play, 디코딩, CSS, 선택 시 canvas 합성

getResourceUrl은 파일을 Blob으로 확보한 후 URL을 반환한다. 정상 파일을 완전히 받은 뒤의 프레임 디코딩과 표시는 브라우저가 처리한다. 다운로드가 실패하면 원격 URL을 그대로 반환하는 대신 오류를 기록하고 null을 반환한다.

따라서 정상 Blob 확보가 확인되면 재생·표시 경로를 우선 조사한다. 다만 이번 자료의 사전 캐시 성공을 모든 아바타 파일의 개별 성공으로 확대해석하지 않는다. 원본 파일 손상과 잘못된 메타데이터도 검증하지 않았다.

실제 오류는 있지만 흰 화면과의 인과관계는 확인되지 않았다

다음 건수는 S3 보관 JSONL 한 파일에서 역할별로 집계한 로그 레코드 수다. 동일 사건이 여러 이유로 중복 기록될 수 있으므로 독립 장애 횟수와 같지 않다.

역할과 메시지건수확인된 의미와 한계
guest · ASR continuation window 적용 실패24'음성 합치기 설정 변경 실패'. agent_trust_pinned와 ready_response_confirmed 등에서 기록됐다. 캐릭터 흰 화면의 원인으로 연결하지 않았다.
guest · Failed to produce mic audio8AwaitQueueStoppedError: queue stopped. 활동 전환 시 연결 정리와 겹친다. 영상 다운로드 실패 로그가 아니다.
guest · guest-step-update ACK 시간 초과318:30 초반에 발생했다. 서버 응답 지연과 네트워크 중 원인을 이 기록만으로 분리할 수 없다.
guest · video setSinkId failed10NotAllowedError: A user gesture is required. 오디오 출력 장치 설정 실패이며 video.play() 거절과 구분한다.
guest · 예상치 못한 video pause118:52:30 엔딩송에서 발생했고 약 60ms 뒤 복구 로그가 있다.
monitor · Consume failed1919건 모두 UNAUTHORIZED다. 모니터의 미디어 구독 경로에서 난 오류다. S3 리소스 다운로드 권한 오류로 해석하지 않는다.

guest는 canplay 7건과 play 이벤트 8건, monitor는 각각 22건이다. 두 역할 모두 직접적인 play 실패, video error 이벤트, 리소스 다운로드 실패 메시지는 0건이다. 이 수치는 주로 MEET_VIDEO 자료 재생 로그이며, 아바타 영상이 정상 재생됐다는 증거로 사용하지 않는다.

아동의 '친구가 안 보여요' 신고는 총 5회다. 모니터의 정상 콘텐츠 재생 기록도 아동 측 아바타의 정상 표시를 보장하지 않는다.

현재 코드는 원인 추적에 필요한 정보를 일부 남기지 않는다

반면 guest의 별도 LOW_POWER_PROBE 44개 표본은 모두 약 58.8fps이며 lowPowerSuspected: false다. 이 값은 수집 시점의 화면 갱신 간격 표본이다. 지속적인 MP4 디코딩 성능이나 GPU 상태를 보장하지 않는다.

다운로드 실패와 소스 연결 실패를 구분할 증거가 더 필요하다

다음 항목은 후속 조사 제안이며 아직 구현하거나 검증하지 않았다.

  1. 아바타 파일별로 선택된 파일명, 리소스 ID, 캐시 적중 여부, 다운로드 결과, Blob 크기를 확인한다. 현재 등록 파일과 당시 사용 파일의 버전·체크섬도 대조한다.
  2. idle·talking 요소에 대해 data-monitor-media, getAttribute("src"), currentSrc, readyState, networkState, videoWidth, videoHeight, video.error를 함께 수집한다.
  3. play 거절과 loadstart, loadeddata, playing, pause, emptied, error를 기록한다. 활동·스텝·아바타 ID와 소스 할당·해제 이유를 같은 순서로 연결한다.
  4. 같은 iPhone 환경에서 tiki_C02reward의 idle·talking 전환과 split:image에서 full:ai로의 전환을 재현한다. 소스 상태가 정상인데도 보이지 않을 때 CSS 표시 상태와 canvas 활성 여부를 확인한다.
  5. 모니터 UNAUTHORIZED는 별도 미디어 구독 문제로 추적한다. 백엔드 오류와의 연관성을 주장하려면 해당 요청·서버 로그를 대조한다.

고객 안내에는 '캐릭터 화면이 표시되지 않는 현상을 확인했고, 영상 로딩과 화면 전환 과정을 조사 중'이라고 설명할 수 있다. 기기 교체나 서버 정상 판정을 이 자료만으로 안내하지 않는다.

근거 자료와 코드 위치

원본은 분석자 로컬 제공 자료다. 아래 줄 번호는 S3 보관 파일의 물리적 JSONL 줄 번호이며, 다운로드 후 JSON을 다시 정렬하면 달라질 수 있다.

주요 로그 건수 재집계

제공 파일 경로를 인자로 전달한다. 출력 건수는 LogRocket JSON을 합산하지 않은 S3 보관 파일 기준이다.

python3 - ~/Downloads/lesson-log-20261113-cc02211c-9aa5-4c5e-8015-0ca0c002a7fc.jsonl.gz <<'PY'
import collections, gzip, json, sys
path = sys.argv[1]
with open(path, "rb") as stream:
	compressed = stream.read(2) == b"\x1f\x8b"
opener = gzip.open if compressed else open
with opener(path, "rt") as stream:
	rows = [json.loads(line) for line in stream if line.strip()]
print("roles", collections.Counter(row["role"] for row in rows))
counts = collections.Counter(
	(row["role"], row["ctx"], row["msg"])
	for row in rows if row["level"] in {"warn", "error"}
)
for key, count in counts.most_common():
	print(count, *key, sep="\t")
PY