--- title: Runbook — DEPENDENCY_4XX_CLIENT (업스트림 클라이언트 오류) category: PERMANENT_DEPENDENCY error_codes: [DEPENDENCY_4XX_CLIENT] severity: P2 owner: oncall last_updated: 2026-06-15 status: 초안 --- # Runbook: DEPENDENCY_4XX_CLIENT (`runbook://dependency/4xx-client`) ## 증상 - HTTP 502, `error.code=DEPENDENCY_4XX_CLIENT`. - 업스트림이 401·403·400을 돌려줬다. 자격 증명, scope, 요청 형식 문제다. ## 진단 - 로그에서 업스트림 응답 본문의 오류 내용을 본다. - API 자격 증명과 scope가 유효한지 확인한다. ## 조치 - 자격 증명이 만료됐으면 교체한다. - API 계약이 바뀌었으면 요청 형식을 고친다. ## 에스컬레이션 - 계약 변경이 의심되면 업스트림 API 소유자에게 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.