ログイン 出店する
← 가이드 목록
시작하기

504 Gateway Timeout이란? 홈페이지가 응답하지 않을 때 나타나는 서버 오류 쉽게 이해하기

504는 중간 서버가 뒤쪽 서버 응답을 기다렸지만 제한 시간 안에 답을 받지 못했다는 뜻입니다. 502와의 차이, 과부하·DB·API·타임아웃, 운영 점검 포인트까지 초보 기준으로 정리합니다.

504 Gateway Timeout이란? 홈페이지가 응답하지 않을 때 나타나는 서버 오류 쉽게 이해하기

홈페이지에 접속했는데 한참 기다린 뒤 504 Gateway Timeout이 나올 때가 있습니다. 502 Bad Gateway와 비슷해 보이지만 의미가 다릅니다.

504는 중간 서버가 뒤쪽 서버의 응답을 기다렸지만, 정해진 시간 안에 답을 받지 못했다는 뜻입니다.

쉽게 말하면 — 주문은 전달했는데 주방에서 너무 오래 답이 오지 않아 기다리기를 포기한 상태

사용자 → 중간 서버가 시간 제한까지 기다림 → 원본 서버 응답이 늦어 504 Timeout
요청은 전달됐지만, 제한 시간 안에 답이 없을 때

Timeout이란?

Timeout은 기다릴 수 있는 시간을 초과했다는 뜻입니다. 중간 서버는 뒤쪽 응답을 무한정 기다리지 않습니다. 예: 「30초 안에 응답이 없으면 중단」으로 설정돼 있으면, 그 안에 답이 없을 때 504가 납니다. 서버가 아예 없다는 뜻이라기보다 응답이 너무 늦었다는 상황에 가깝습니다.


502와 504의 차이

  • 502 — 뒤쪽에서 이상한(비정상) 답을 받음
  • 504 — 정해진 시간 안에 답 자체가 없음

500은 「지금 처리 중인 서버 내부」 문제이고, 502·504는 「중간↔뒤쪽」 축에 가깝습니다.


흔한 원인

  • 과부하 — 갑작스러운 접속으로 처리가 밀림
  • 긴 프로그램 작업 — DB 조회·통계·이미지·외부 호출·AI 등
  • 느린 데이터베이스 — 상품·재고·리뷰 조회가 늦어 전체 응답 지연
  • 외부 API 지연 — 결제·배송·문자·본인인증·AI 등 협력 서비스 대기
  • 서버 간 네트워크 — 중간↔원본 통신이 느리거나 불안정
  • 원본 앱 정지 — 답이 안 와 기다리다 시간 초과(구성에 따라 502로 보일 수도)

특정 페이지만 504일 때

메인·회사소개는 정상인데 전체 상품 검색만 504라면, 서버 전체 고장이라기보다 그 작업이 너무 오래 걸리는 경우가 많습니다. 검색·통계·보고서·대용량 파일·데이터 내보내기가 대표적입니다.


방문자 vs 운영자

방문자는 잠시 후 재접속·새로고침·특정 페이지만인지 확인 정도입니다. 운영자는 Timeout만 늘리기 전에 왜 느린지를 봅니다. CPU·메모리·DB 속도·프로그램 로그·외부 API 응답·최근 수정 내용을 점검하세요.


Timeout만 늘리면?

작업이 정상 완료되지만 항상 35초인데 제한이 30초라면 일시적으로 도움이 될 수 있습니다. 하지만 1초면 될 일을 2분씩 한다면, 손님에게 「더 오래 기다리세요」만 하는 것과 같습니다. 근본적으로 느린 지점(쿼리·API·사양)을 찾는 편이 낫습니다. 서버 사양 상향은 자원 부족일 때 도움이 되고, 느린 코드·외부 API가 원인이면 효과가 작을 수 있습니다.


캐시 · CDN · Cloudflare

자주 같은 결과를 다시 계산하지 않게 캐시를 두면 부하를 줄일 수 있습니다. CDN·Cloudflare가 중간이면, 원본이 너무 늦을 때 504가 사용자에게 보일 수 있습니다. CDN만의 고장이 아닐 수 있으니 원본 응답 속도도 확인하세요. 광고·이벤트 전엔 자원·캐시·CDN·DB 최적화를 미리 검토하는 것이 좋습니다. 중간 중계는 프록시·리버스 프록시 글도 참고하세요.


인터넷 느림 · 408과의 차이

집 인터넷이 느린 것과 504는 다릅니다. 504는 보통 서버↔서버 대기 초과입니다. 408 Request Timeout은 서버가 사용자 요청을 제시간에 못 받은 쪽에 가깝고, 504는 웨이터가 주문을 받았지만 주방 답이 안 온 경우입니다. (HTTP 상태 코드로 결과를 알립니다.)


사업·검색·전조 신호

주문·결제·예약·회원가입에서 504가 나면 「처리됐는지」 혼란이 큽니다. 중요 기능은 결과 확인이 가능해야 합니다. 잠깐이면 검색 영향이 작을 수 있지만, 반복되면 검색·사용자 모두 이탈하기 쉽습니다. 평소 1~2초이던 페이지가 20~30초로 길어지면 504의 전조일 수 있으니, 모니터링으로 정상 여부·응답시간·상태 코드를 먼저 발견하는 편이 좋습니다.


문의 팁

「오후 4시부터 상품 검색만 504 · 메인·회사소개 정상 · 조건이 많을수록 자주」 또는 「전 페이지가 느려지다 약 30초 뒤 504」처럼 시각·URL·범위를 알려 주세요.


자주 묻는 질문

504란?

중간 서버가 뒤쪽 서버 응답을 기다리다 제한 시간을 넘긴 경우입니다.

홈페이지가 삭제됐나요?

아닙니다. 응답이 너무 느리거나 서버 간 통신에 문제가 난 경우가 많습니다.

502와 차이는?

502는 비정상 응답, 504는 시간 안에 응답 없음입니다.

새로고침하면?

일시 과부하면 될 수 있습니다. 반복되면 서버 점검이 필요합니다.

사양만 올리면?

자원 부족이면 도움이 됩니다. 느린 프로그램·DB·API면 다른 개선이 필요합니다.

Timeout만 늘리면?

일부는 가능하지만, 처리가 원래 너무 느리면 근본 원인부터 고치는 편이 낫습니다.


정리

502 = 주방에서 이상한 답이 왔다 · 504 = 아무리 기다려도 답이 오지 않았다

과부하·느린 DB·긴 작업·외부 API·네트워크 등에서 납니다. 반복되면 Timeout만 늘리기보다 병목을 찾으세요. 서버는 있지만 점검·과부하로 일시적으로 서비스를 못 줄 때 자주 보는 오류는 503 Service Unavailable입니다.