HTTP 504 Gateway Timeout
504는 서버 오류(5xx) 응답이에요. 아래 숫자를 바꿔 다른 코드도 바로 찾아볼 수 있어요.
파일은 서버로 전송되지 않고 내 기기에서만 처리돼요
HTTP 상태 코드 · 5xx 서버 오류
504 Gateway Timeout
게이트웨이 시간 초과 — 게이트웨이나 프록시가 뒤쪽 서버의 응답을 제때 받지 못했다는 뜻이에요.
| 이름 | 504 Gateway Timeout |
|---|---|
| 분류 | 5xx 서버 오류 |
| 정의 문서 | RFC 9110 §15.6.5 |
| 기본 캐시 | 명시적 캐시 지시가 있을 때만 |
| 관련 헤더 | 특별히 정한 헤더 없음 |
응답 예시
HTTP/1.1 504 Gateway Timeout Date: Thu, 12 Nov 2026 03:00:00 GMT
다른 상태 코드 찾아보기
HTTP 504 Gateway Timeout 뜻
504 Gateway Timeout(게이트웨이 시간 초과)는 5xx 서버 오류 응답이에요. 5xx는 서버가 올바른 요청을 처리하지 못했다는 응답이에요. 게이트웨이나 프록시가 뒤쪽 서버의 응답을 제때 받지 못했다는 뜻이에요. 정의는 HTTP 의미론 표준인 RFC 9110의 15.6.5절에 있어요.

캐시: RFC 9110은 200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414, 501을 ‘기본으로 캐시 가능(heuristically cacheable)’으로 정해요. 504는 이 목록에 없어서, 응답에 Cache-Control이나 Expires로 캐시를 허락해야만 저장돼요.
사용자로서 이 코드를 봤다면
서버 응답이 너무 느려요. 잠시 뒤 다시 시도하세요.
개발자라면
앱 서버의 처리가 프록시 시간 제한보다 오래 걸릴 때 생겨요. 오래 걸리는 작업은 202로 바꾸는 걸 고려하세요.
같은 분류의 다른 코드
| 코드 | 이름 | 한국어 | 기본 캐시 |
|---|---|---|---|
| 500 | Internal Server Error | 서버 내부 오류 | - |
| 501 | Not Implemented | 구현되지 않음 | 가능 |
| 502 | Bad Gateway | 잘못된 게이트웨이 | - |
| 503 | Service Unavailable | 서비스 이용 불가 | - |
| 505 | HTTP Version Not Supported | HTTP 버전 미지원 | - |
| 506 | Variant Also Negotiates | 변형도 협상 중 | - |
| 507 | Insufficient Storage | 저장 공간 부족 | - |
| 508 | Loop Detected | 반복 감지 | - |
| 510 | Not Extended | 확장 필요(폐지) | - |
| 511 | Network Authentication Required | 네트워크 인증 필요 | - |
이어서 보기
참고한 자료
- IANA Hypertext Transfer Protocol (HTTP) Status Code Registry (등록 이름·참조 문서, 확인 2026-11-12)
- RFC 9110 HTTP Semantics — 15. Status Codes (정의·필수 헤더·기본 캐시 가능 코드, 확인 2026-11-12)
자주 묻는 질문
HTTP 504 오류는 무슨 뜻이에요?
게이트웨이 시간 초과라는 뜻의 5xx 서버 오류 응답이에요. 게이트웨이나 프록시가 뒤쪽 서버의 응답을 제때 받지 못했다는 뜻이에요.
504 응답은 캐시되나요?
기본으로 캐시 가능한 코드가 아니라서 Cache-Control 같은 지시가 있어야 캐시돼요.
504와 502의 차이는요?
504는 시간 초과, 502는 잘못된 응답이에요.
함께 쓰면 좋은 도구
- JSON 정리 (보기 좋게 들여쓰기·검증·압축)JSON을 보기 좋게 들여쓰기, 오류 위치 표시, 한 줄 압축, 키 정렬, 문자열 이스케이프
- 메타 태그 만들기 (SEO·오픈그래프·카톡 공유 미리보기)제목·설명·대표 이미지로 SEO·오픈그래프·트위터 카드 태그를 만들고, 검색·카톡 공유 미리보기 확인
- 정규식 테스트 (정규표현식 매칭 확인)패턴과 플래그로 일치하는 부분을 강조 표시, 그룹 값 표, 바꾸기 미리보기, 자주 쓰는 패턴
- Base64 인코딩·디코딩 (글자·파일 ↔ Base64)글자(한글 UTF-8)를 Base64로, Base64를 글자로, 파일·이미지를 data URI로, Base64를 파일로 저장
- 색상 코드 변환 (HEX·RGB·HSL·CMYK)HEX·RGB·HSL·HSV·CMYK를 서로 바꾸고, 글자 대비(WCAG) 검사, 밝게·어둡게 단계 표
- 색상 팔레트 만들기 (어울리는 색 조합·사진에서 색 뽑기)대표 색 하나로 보색·유사색·삼각 배색·단계색 팔레트, 사진에서 주요 색 뽑기, CSS·PNG로