--- title: Runbook — AUTH_TOKEN_MALFORMED (토큰 파싱 실패) category: AUTH error_codes: [AUTH_TOKEN_MALFORMED, INVALID_TOKEN] severity: P3 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: AUTH_TOKEN_MALFORMED (`runbook://auth/token-malformed`) ## 증상 - HTTP 401 응답, `error.code=AUTH_TOKEN_MALFORMED`. - 토큰은 있지만 JWT로 파싱되지 않는다(세 부분이 아님, base64가 아님 등). ## 진단 - 로그에서 Authorization 헤더 원문을 본다. - 토큰을 만드는 도구에 버그가 있는지 확인한다. ## 조치 - 잘못된 토큰이 어디서 오는지 찾는다. - 클라이언트의 토큰 생성을 고친다. ## 에스컬레이션 - 급증이 인프라 문제를 가리키면 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.