76d429e2 8회기 재입장 — AI 세션 7회 모두 LESSON_COMPLETED(409), 수업 상태 DDB·ppi-api 불일치 분석근본 원인 DB 확인 필요 · 코드 변경 없음

마지막 업데이트 2026-10-23

2026-10-23 사건 2026-10-23 18:30–18:34 roomId 76d429e2-…_8 · iPhone iOS 26.6.1 · Chrome(CriOS) · 저사양 판정

요약

증상: 아동이 8회기에 입장해 영상 스텝은 정상으로 진행했지만 AI 대화 스텝마다 AI가 붙지 않았다. AI 세션 시작 7번이 모두 실패했다. 진행자가 두 번 강제퇴장했고 아동이 재입장했지만 결과는 같았다.

직접 원인: PPI web API POST /api/livekit/call이 매번 409 {error:"LESSON_COMPLETED"}로 거절했다. 수업 세션 생성 POST /api/lessons/{uid}/8/sessions도 입장 직후부터 409(LESSON_ALREADY_TERMINATED로 추정)였다. 두 API 모두 DynamoDB Lesson 레코드의 completionStatus가 PENDING(0)이 아니어서 거절했다. LiveKit, OpenAI 같은 외부 서비스나 네트워크 문제가 아니다.

왜 입장은 됐나: 입장 검사 /api/validate-lesson은 DDB 레코드의 completionStatus를 ppi-api 값으로 덮어쓴 뒤 종료 수업을 거른다. 그래서 ppi-api에서는 PENDING, DDB에서는 종료 상태인 수업이 입장은 통과하고 실행 단계에서만 막혔다.

근본 원인(추정, DB 확인 필요): 이 아동의 8회기는 어제(2026-10-22 18:30–18:36)에 이미 진행됐다(어제 무음 사건). 이후 오늘 18:30으로 다시 잡혔지만, ppi-api 상태만 PENDING으로 되돌아가고 DDB의 종료 표식은 남은 것으로 보인다.

1. 시간순 인과

// 2026-10-23 KST · 아동 단말: iPhone, iOS 26.6.1, Chrome(CriOS), lowPerf=true · LogRocket 1개 탭
18:20:39     /guest 진입 → 다른 저장 계정 로그아웃 → 76d429e2 로그인
18:21:07     대기실 진입 plannedStartTime 2026-10-23T09:30Z (오늘 18:30)
18:30:00     대기실 자동 재시도 → validate-lesson 통과 → V2FlowRedirect lessonIndex 8
18:30:01     /client-guest/session?roomId=…_8 · 소켓 JOIN 정상 · mediasoup 송출 정상
18:30:08     아동 준비 확인 → POST …/8/sessions → 409
18:30:09     오프닝 영상 재생 (정상)
18:30:56     영상 넘김 → 다온소개(AI 활동) → POST /api/livekit/call → 409 LESSON_COMPLETED
18:31:43     같은 활동 재시도 → LESSON_COMPLETED
18:32:31     진행자 강제퇴장 → 18:32:41 /guest 재진입 → 18:32:46 다시 session
18:32:52     POST …/8/sessions 409 · AI 세션 LESSON_COMPLETED
18:33:16 ~ 18:33:35   AI 세션 4회 더 시도 → 전부 LESSON_COMPLETED
18:33:48     진행자 강제퇴장 (로그 끝)

7번 모두 브라우저 쪽 준비(마이크 스트림, peer connection, offer, data channel)는 끝났다. create_session_request_begin 뒤 약 60ms 만에 session_start_failed가 났고, 연결 성공 단계까지 간 시도는 없다.

2. 코드 경로 — 누가 어떤 상태값으로 판정하나

경계상태 출처판정코드
입장 검사
POST /api/validate-lesson
DDB getLessons → ppi-api completionStatus로 덮어씀terminal이면 후보에서 제외app/api/validate-lesson/route.ts, lib/lesson-ppi-api-utils.ts (...(completionStatus !== undefined && { completionStatus })), lib/api/lesson-entry-selection.ts getActivePlannedLessons
수업 세션 생성
POST /api/lessons/{uid}/{idx}/sessions
DDB lessonDao.getLessonPENDING 아니면 LESSON_ALREADY_TERMINATED → 409lib/api/services/lesson-session.service.ts, lesson-session.controller.ts
AI 세션(LiveKit)
POST /api/livekit/call
DDB getLesson(uid, idx, true) (강한 일관성 읽기)PENDING 아니면 LESSON_COMPLETED → 409app/api/livekit/call/route.ts (토큰·dispatch 전에 반환)

이 실행 경계 게이트는 terminal 게이트 전환 설계에서 "중단 뒤에도 수업이 계속되는" 문제를 막으려고 넣은 것이다. 이번 건은 반대 방향의 부작용이다. 입장 경계와 실행 경계가 서로 다른 상태 출처를 보기 때문에, 두 값이 어긋나면 "입장은 되는데 AI만 안 되는" 상태가 생긴다.

3. 단계별 근거

단계근거 (LogRocket)판정
입장 검사18:30:00 GuestEntry:V2FlowRedirect {lessonIndex: 8} — validate-lesson이 8회기를 활성 수업으로 골랐다ppi-api 기준 PENDING
소켓·SFUJoined room successfully, Camera/Mic producer created, send transport connected정상
수업 세션 생성[LESSON_SESSION] Session creation failed {status: 409} 2회 (입장마다 첫 요청)DDB 기준 종료
AI 세션[AI_SESSION] Failed to start session {error: 'LESSON_COMPLETED'} 7회, EXCEPTION LESSON_COMPLETED 6회DDB 기준 종료
영상 스텝오프닝·다온소개 영상 loadstart → play 정상정상

4. 주의사항 — 오진 함정

  • ICE_DIAGNOSTIC_SUMMARY ERROR(source: realtime)는 원인이 아니다. 매번 session_start_failed와 같은 밀리초에 찍혔다. 실패 뒤 peer connection을 정리하면서 남긴 진단이다.
  • 소켓 uplink stall(54초), Guest step commit retry exhausted는 step 동기화 지연이다. 18:30:56에 회복됐고 AI 세션 거절과는 무관하다.
  • WebRTC loopback connection timeout(영상 오디오 루프백)과 setSinkId NotAllowedError도 별개 문제다.
  • LESSON_COMPLETED와 LESSON_COMPLETED_OR_UNAVAILABLE는 다르다. 후자는 같은 route에서 소켓 admission 확인이 거절될 때 나온다. 이번 건은 전자이므로 DDB 상태 확인 단계에서 막혔다.
  • 진행자 강제퇴장은 결과다. AI가 붙지 않자 진행자가 재입장을 유도한 것으로 보이며, 재입장 뒤에도 같은 409가 반복됐다.

5. 미확정 사항과 확인 방법

  1. DDB Lesson(76d429e2-30c1-45cd-9524-68917798197c, index 8)의 completionStatus 값(100 완료 / 200 중단 / 300 취소)과 갱신 시각을 확인한다. 어제 18:36 무렵이면 어제 세션 종료 표식이 남은 것이다.
  2. ppi-api class-mgmt의 같은 회기 상태·날짜를 확인한다. 날짜가 10-23으로 바뀌고 상태가 PENDING이면 "일정만 다시 잡히고 DDB는 안 되돌아간" 경로가 확정된다.
  3. Loki {service_name="ppi-web"}에서 어제·오늘 PUT /api/lessons/76d429e2…/8, /reset, ppi-api PATCH …/status 호출 기록으로 누가 어느 쪽만 바꿨는지 추적한다.

6. 대응과 제안 (코드 변경 없음)

현장 조치

  1. 8회기를 다시 진행하려면 해당 lesson을 reset(/api/lessons/[userId]/[index]/reset)해서 DDB 상태를 PENDING으로 맞춘다. 운영 데이터 수정이므로 담당자 확인 후 진행한다.

제품·코드 제안

  1. 상태 출처 일치: validate-lesson도 DDB의 terminal 표식을 함께 확인하거나, 실행 게이트와 같은 판정 함수를 공유한다. 한쪽이라도 terminal이면 입장 단계에서 막고 안내한다.
  2. 재스케줄 시 동기화: 회기를 다른 날짜로 다시 잡거나 상태를 PENDING으로 되돌리는 경로가 DDB completionStatus도 함께 되돌리는지 점검한다.
  3. 아동·진행자 안내: LESSON_COMPLETED 409를 받으면 AI 재시도를 반복하지 말고 "이미 종료된 수업" 상태를 진행자 화면에 띄운다. 이번처럼 진행자가 원인을 모른 채 강제퇴장을 반복하지 않게 한다.

7. 데이터 출처