AI 내부 예외 문자열이 SSE 로 브라우저까지 나가던 문제

[i3months]

문제

AI 서버는 질문 생성 실패 시 콜백에 error_message=str(exc) 를 담는다 (questions_consumer.py).

return QuestionPoolCallbackPayload(
    ...
    error_message=str(exc),
)

Core 의 QuestionsCallbackService.publishErrorEvent 가 이 값을 그대로 SessionErrorNotice 에 넣어 세션·유저 SSE 채널 양쪽으로 발행했다. RealTime 이 이를 브라우저로 흘린다.

str(exc) 에 실제로 들어올 수 있는 것:

예외	노출되는 내용
APIConnectionError	llm_base_url = 사내 LLM 게이트웨이 주소
APIStatusError (429/400)	업스트림 오류 본문 — 조직 식별자·모델명·쿼터 잔량
파싱 실패	모델 원문 전체

게다가 프론트엔드는 이 필드들을 하나도 읽지 않는다. interviewEventAction 이 ERROR 를 rollback-optimistic 으로만 처리하고 payload 는 버린다. 소비자도 없이 내부 정보만 브라우저로 나가고 있었다.

수정

publishErrorEvent 가 클라이언트로는 우리가 정의한 코드에서 만든 문구만 보낸다.

• SessionErrorNotice.errorMessage → message 로 이름 변경 (내부 원문이 아니라 사용자 문구라는 걸 타입에서 드러냄)
• ERROR_MESSAGES 화이트리스트: GENERATION_FAILED / GENERATION_SCHEMA_INVALID → 한국어 안내
• errorCode 도 화이트리스트를 태운다 — errorCode 역시 AI 가 채우는 문자열이라, 언젠가 예외 속성에서 끌어다 쓰게 되면 같은 경로로 샌다. 모르는 코드는 GENERATION_FAILED 로 접는다
• 원문은 손대지 않았다 — 같은 메서드 위 log.warn 이 이미 errorCode·retriable·errorMessage 를 서버 로그에 남긴다. 디버깅 정보는 그대로 유지된다

테스트

QuestionsCallbackServiceTest 2 케이스 추가:

• apply_followupFailedWithoutPlaceholder_doesNotLeakInternalErrorMessage — 게이트웨이 주소·조직 식별자·Errno 가 발행된 RealtimeNotifyEvent 어디에도 없음
• apply_followupFailedWithUnknownErrorCode_fallsBackToKnownCode — 모르는 errorCode 에 담긴 문자열이 새어 나가지 않음

수정 전 코드에서 정확히 이 2개만 실패하는 것을 확인했다 (25 tests completed, 2 failed). 수정 후 백엔드 전체 스위트 통과.

프론트 영향

없다. 프론트가 이 필드들을 읽지 않으므로 errorMessage → message 리네임은 화면에 영향이 없다. (SSE payload 는 OpenAPI 스펙 대상이 아니라 타입 재생성도 불필요.)