LESSON_COMPLETED(409), 수업 상태 DDB·ppi-api 불일치
분석근본 원인 DB 확인 필요 · 코드 변경 없음마지막 업데이트 2026-10-23
증상: 아동이 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의 종료 표식은 남은 것으로 보인다.
// 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가 났고, 연결 성공 단계까지 간 시도는 없다.
| 경계 | 상태 출처 | 판정 | 코드 |
|---|---|---|---|
입장 검사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.getLesson | PENDING 아니면 LESSON_ALREADY_TERMINATED → 409 | lib/api/services/lesson-session.service.ts, lesson-session.controller.ts |
AI 세션(LiveKit)POST /api/livekit/call | DDB getLesson(uid, idx, true) (강한 일관성 읽기) | PENDING 아니면 LESSON_COMPLETED → 409 | app/api/livekit/call/route.ts (토큰·dispatch 전에 반환) |
이 실행 경계 게이트는 terminal 게이트 전환 설계에서 "중단 뒤에도 수업이 계속되는" 문제를 막으려고 넣은 것이다. 이번 건은 반대 방향의 부작용이다. 입장 경계와 실행 경계가 서로 다른 상태 출처를 보기 때문에, 두 값이 어긋나면 "입장은 되는데 AI만 안 되는" 상태가 생긴다.
| 단계 | 근거 (LogRocket) | 판정 |
|---|---|---|
| 입장 검사 | 18:30:00 GuestEntry:V2FlowRedirect {lessonIndex: 8} — validate-lesson이 8회기를 활성 수업으로 골랐다 | ppi-api 기준 PENDING |
| 소켓·SFU | Joined 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 정상 | 정상 |
ICE_DIAGNOSTIC_SUMMARY ERROR(source: realtime)는 원인이 아니다. 매번 session_start_failed와 같은 밀리초에 찍혔다. 실패 뒤 peer connection을 정리하면서 남긴 진단이다.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 상태 확인 단계에서 막혔다.76d429e2-30c1-45cd-9524-68917798197c, index 8)의 completionStatus 값(100 완료 / 200 중단 / 300 취소)과 갱신 시각을 확인한다. 어제 18:36 무렵이면 어제 세션 종료 표식이 남은 것이다.{service_name="ppi-web"}에서 어제·오늘 PUT /api/lessons/76d429e2…/8, /reset, ppi-api PATCH …/status 호출 기록으로 누가 어느 쪽만 바꿨는지 추적한다./api/lessons/[userId]/[index]/reset)해서 DDB 상태를 PENDING으로 맞춘다. 운영 데이터 수정이므로 담당자 확인 후 진행한다.completionStatus도 함께 되돌리는지 점검한다.LESSON_COMPLETED 409를 받으면 AI 재시도를 반복하지 말고 "이미 종료된 수업" 상태를 진행자 화면에 띄운다. 이번처럼 진행자가 원인을 모른 채 강제퇴장을 반복하지 않게 한다.6-01a1680f…/0/9cf78ca2…, appID tbwewz/ppi-prod), 718개 항목.develop fc5976e5 기준.