--- title: Runbook — DOWNLOAD_STREAMING_FAILURE (스트리밍 다운로드 실패) category: TRANSIENT_DEPENDENCY error_codes: [DOWNLOAD_STREAMING_FAILURE] severity: P2 owner: oncall last_updated: 2026-11-07 status: 초안 --- # Runbook: DOWNLOAD_STREAMING_FAILURE (`runbook://file/download-streaming-failure`) ## 증상 - HTTP 503, `error.code=DOWNLOAD_STREAMING_FAILURE`. - 스트리밍 응답이 잘렸다. backpressure나 시간 초과(60초 / 100MB 한도)다. - 지금 템플릿은 이 코드를 내지 않는다. `docs/registries/error-codes.yaml`에 이 코드의 행이 없다. 파일 서버 다운로드 장애는 [`docs/fileserver/operations.md`](../fileserver/operations.md)를 먼저 본다. ## 진단 - 스트리밍 응답 시간 상한 설정을 확인한다. - 다운로드 크기를 100MB 한도와 비교한다. ## 조치 - 저장소 백엔드에 닿는지 확인한다. - 다운로드 경로의 네트워크 혼잡을 확인한다. ## 에스컬레이션 - 저장소 백엔드가 나빠졌으면 인프라 팀에 넘긴다. --- > **초안**: 서비스가 도메인을 채운 뒤 본문을 쓴다.