인터넷을 이용하다 보면 웹사이트에 접속하는 과정에서 갑자기 504 Gateway Timeout이라는 오류 메시지가 나타나는 경우가 있습니다.
평소 정상적으로 접속하던 사이트에서 이러한 오류가 발생하면 인터넷 연결에 문제가 있는 것인지, 서버가 고장 난 것인지 헷갈릴 수 있습니다.
특히 워드프레스나 개인 블로그를 운영하는 경우에는 504 오류가 반복되면 방문자가 사이트를 이용하지 못하고 검색엔진 크롤링에도 문제가 생길 수 있기 때문에 원인을 확인하는 것이 중요합니다.
이번 글에서는 504 Gateway Timeout 오류가 발생하는 원인과 해결 방법을 일반 사용자와 웹사이트 운영자 입장에서 각각 알아보겠습니다.
504 Gateway Timeout이란?
504 Gateway Timeout은 웹서버가 다른 서버로부터 정해진 시간 안에 응답을 받지 못했을 때 발생하는 HTTP 오류 코드입니다.
일반적으로 웹사이트에 접속하면 브라우저의 요청이 웹서버로 전달되고, 필요한 경우 웹서버는 다른 서버나 애플리케이션에 데이터를 요청합니다.
그런데 중간에서 요청을 전달하는 게이트웨이 또는 프록시 서버가 상위 서버로부터 제한 시간 안에 응답을 받지 못하면 504 오류가 발생할 수 있습니다.
쉽게 말하면 서버가 다른 서버의 응답을 기다리다가 시간이 초과된 상황입니다.
대표적으로 다음과 같은 메시지가 나타날 수 있습니다.
- 504 Gateway Timeout
- 504 Gateway Time-out
- HTTP Error 504
- Error 504
- The server didn’t respond in time
오류 메시지는 사용하는 웹서버나 CDN 서비스에 따라 다르게 표시될 수 있습니다.
504 Gateway Timeout 오류가 발생하는 원인
504 오류는 여러 가지 원인으로 발생할 수 있지만 대표적으로 다음과 같은 경우가 있습니다.
1. 서버 과부하
웹사이트에 갑자기 많은 방문자가 몰리면 서버가 모든 요청을 빠르게 처리하지 못할 수 있습니다.
특히 서버의 CPU나 메모리 사용량이 높아지거나 동시에 처리할 수 있는 요청 수가 부족하면 응답이 지연될 수 있습니다.
이러한 상황이 지속되면 프록시 서버에서 정해진 대기 시간을 초과해 504 오류가 발생할 수 있습니다.
2. 서버 간 통신 문제
웹사이트는 하나의 서버만 사용하는 것이 아니라 여러 서버가 연결되어 작동하는 경우가 많습니다.
예를 들어 Nginx가 웹 요청을 받아 PHP-FPM이나 별도의 애플리케이션 서버로 전달하는 구조를 사용할 수 있습니다.
이때 서버 간 네트워크 연결이 불안정하거나 상위 서버의 응답이 늦어지면 504 오류가 발생할 수 있습니다.
3. 데이터베이스 응답 지연
워드프레스와 같은 웹사이트는 MySQL이나 MariaDB 등의 데이터베이스를 사용합니다.
데이터베이스에 처리 시간이 긴 쿼리가 실행되거나 서버 자원이 부족해지면 웹페이지 생성이 늦어질 수 있습니다.
이러한 지연이 누적되면 최종적으로 504 오류가 발생할 수 있습니다.
4. 워드프레스 플러그인 문제
워드프레스에서 특정 플러그인이 과도한 서버 자원을 사용하거나 외부 API의 응답을 오래 기다리는 경우에도 문제가 발생할 수 있습니다.
특히 백업, 보안 검사, 데이터 동기화, 대량 이미지 처리 등의 작업이 서버에 부담을 줄 수 있습니다.
다만 504 오류가 발생했다고 해서 반드시 플러그인에 문제가 있는 것은 아닙니다.
5. 프록시 및 CDN 설정 문제
Cloudflare와 같은 CDN이나 리버스 프록시를 사용하는 경우 원본 서버와의 통신 과정에서 시간 초과가 발생할 수 있습니다.
원본 서버가 정상적으로 요청을 처리하지 못하거나 서버 간 연결에 문제가 발생하면 504 오류가 표시될 수 있습니다.
504 Gateway Timeout 해결 방법
504 오류를 해결하려면 먼저 문제가 사용자 측에서 발생하는지, 웹사이트 서버에서 발생하는지 구분하는 것이 좋습니다.
일반 방문자라면 다음 방법을 순서대로 시도할 수 있습니다.
1. 웹페이지 새로고침
가장 간단한 방법은 웹페이지를 새로고침하는 것입니다.
일시적인 서버 과부하나 네트워크 지연 때문에 발생한 오류라면 잠시 후 정상적으로 접속될 수 있습니다.
Windows에서는 F5 또는 Ctrl + R을 눌러 새로고침할 수 있습니다.
다만 결제나 주문처럼 중복 요청이 문제가 될 수 있는 화면에서는 새로고침 전에 처리 상태를 확인하는 것이 좋습니다.
2. 다른 웹사이트 접속 확인
현재 인터넷 연결에 문제가 있는지 확인하기 위해 다른 웹사이트에 접속해 봅니다.
다른 사이트는 정상적으로 접속되는데 특정 사이트에서만 504 오류가 발생한다면 해당 사이트의 서버나 연결된 서비스에 문제가 있을 가능성이 있습니다.
반대로 여러 사이트에서 동시에 접속 문제가 발생한다면 인터넷 연결이나 네트워크 환경도 확인할 필요가 있습니다.
3. 브라우저 캐시 삭제
브라우저에 저장된 캐시나 쿠키가 사이트 접속 문제에 영향을 주는 경우가 있습니다.
크롬 브라우저에서는 다음 순서로 캐시를 삭제할 수 있습니다.
- 크롬 브라우저 실행
- 오른쪽 상단 점 세 개 메뉴 선택
- 인터넷 사용 기록 삭제 선택
- 캐시된 이미지 및 파일 선택
- 데이터 삭제
단, 504 오류는 기본적으로 서버 간 응답 시간 초과 문제이기 때문에 캐시를 삭제한다고 반드시 해결되는 것은 아닙니다.
4. 인터넷 연결 변경
현재 와이파이를 사용하고 있다면 모바일 데이터로 접속해 보거나 다른 네트워크를 이용해 확인할 수 있습니다.
VPN이나 프록시 서비스를 사용하고 있다면 일시적으로 해제한 뒤 접속해 보는 것도 도움이 됩니다.
이 방법은 네트워크 경로에 따른 접속 문제를 구분할 때 유용합니다.
5. 잠시 기다린 후 다시 접속
504 오류는 웹사이트 서버에서 일시적으로 발생하는 경우도 있습니다.
서버 점검이나 일시적인 과부하가 원인이라면 사이트 관리자가 문제를 해결한 뒤 정상적으로 접속될 수 있습니다.
따라서 여러 방법을 시도해도 문제가 해결되지 않는다면 잠시 기다렸다가 다시 접속하는 것이 좋습니다.
워드프레스 504 Gateway Timeout 해결 방법
워드프레스를 운영하는 관리자라면 일반 사용자보다 조금 더 구체적으로 원인을 확인할 수 있습니다.
특히 특정 페이지에서만 오류가 발생하거나 관리자 페이지에 접속할 때 504 오류가 나타난다면 서버 자원과 플러그인 상태를 확인하는 것이 좋습니다.
1. 워드프레스 플러그인 확인
최근 설치하거나 업데이트한 플러그인이 있다면 해당 플러그인을 우선적으로 확인합니다.
워드프레스 관리자 페이지에 접속할 수 있다면 플러그인을 하나씩 비활성화하면서 문제가 해결되는지 확인할 수 있습니다.
관리자 페이지에도 접속할 수 없다면 호스팅 파일 관리자나 SFTP를 통해 플러그인 폴더 이름을 변경하는 방법을 사용할 수 있습니다.
일반적으로 플러그인 폴더 경로는 다음과 같습니다.
wp-content/plugins
전체 플러그인을 비활성화하려면 해당 폴더 이름을 임시로 변경할 수 있습니다.
다만 이 방법은 사이트 기능에 영향을 줄 수 있으므로 작업 전에 백업을 진행하는 것이 좋습니다.
2. 서버 CPU와 메모리 사용량 확인
웹호스팅 관리 페이지나 서버 모니터링 도구에서 CPU와 메모리 사용량을 확인합니다.
서버 자원이 부족하면 PHP 요청이나 데이터베이스 작업이 지연될 수 있습니다.
특히 방문자가 증가하는 특정 시간대에만 504 오류가 발생한다면 서버 자원 부족 여부를 확인할 필요가 있습니다.
3. PHP-FPM 상태 확인
Nginx와 PHP-FPM을 사용하는 환경이라면 PHP-FPM의 프로세스 수나 요청 처리 상태를 확인해야 합니다.
동시에 처리할 수 있는 PHP 요청 수가 부족하거나 특정 요청이 오랫동안 실행되면 응답이 지연될 수 있습니다.
이 경우 PHP-FPM 로그와 서버 자원 사용량을 함께 확인하는 것이 좋습니다.
4. 데이터베이스 최적화
워드프레스는 게시글, 댓글, 설정값 등 다양한 데이터를 데이터베이스에 저장합니다.
데이터베이스에 비효율적인 쿼리가 많거나 서버 성능이 부족하면 페이지 응답 속도가 느려질 수 있습니다.
필요하다면 느린 쿼리 로그를 확인하고 데이터베이스 인덱스 및 쿼리 성능을 점검할 수 있습니다.
다만 데이터베이스를 직접 수정하거나 정리하기 전에는 반드시 백업해야 합니다.
Nginx 504 Gateway Timeout 해결 방법
Nginx 서버를 직접 관리하고 있다면 프록시 타임아웃 설정을 확인할 수 있습니다.
Nginx에서는 상위 서버의 응답을 기다리는 시간을 설정할 수 있으며 대표적인 설정은 다음과 같습니다.
location / {
proxy_pass http://backend;
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 120s;
}
위 설정에서 proxy_read_timeout은 프록시 서버가 상위 서버로부터 데이터를 읽는 과정에서 적용되는 시간 제한입니다.
다만 이 값은 전체 요청의 최대 처리 시간을 의미하는 것이 아니라 연속된 읽기 작업 사이에 적용되는 타임아웃입니다.
PHP-FPM과 FastCGI를 사용하는 경우에는 proxy_read_timeout이 아니라 fastcgi_read_timeout 등의 설정을 확인해야 합니다.
주의할 점은 타임아웃 값을 무조건 늘리는 것이 근본적인 해결 방법은 아니라는 것입니다.
실제로 서버가 느려지는 원인이 데이터베이스, PHP 프로세스, 외부 API 등에 있다면 해당 문제를 먼저 해결해야 합니다.
설정을 변경했다면 적용 전에 다음 명령어로 문법을 검사할 수 있습니다.
sudo nginx -t
문제가 없다면 서버 환경에 맞는 방법으로 Nginx 설정을 다시 불러옵니다.
sudo systemctl reload nginx
위 명령어는 systemd를 사용하는 일반적인 리눅스 서버 환경의 예시입니다.
Cloudflare 504 Gateway Timeout 해결 방법
Cloudflare를 사용하는 웹사이트에서 504 오류가 발생한다면 Cloudflare와 원본 서버 사이의 연결 상태를 확인해야 합니다.
먼저 원본 서버가 정상적으로 작동하는지 확인합니다.
원본 서버에서도 응답 지연이 발생한다면 Cloudflare 설정을 변경하기보다는 원본 서버의 성능과 로그를 확인하는 것이 우선입니다.
또한 방화벽에서 Cloudflare의 연결이 차단되고 있지 않은지, 원본 서버의 네트워크 연결에 문제가 없는지 확인할 수 있습니다.
Cloudflare가 표시하는 오류 화면의 형태와 응답 헤더에 따라 원인 분석 방법이 달라질 수 있습니다.
따라서 Cloudflare를 사용한다는 이유만으로 모든 504 오류가 Cloudflare 자체의 장애라고 판단해서는 안 됩니다.
504 오류와 502 오류의 차이
504 Gateway Timeout과 함께 자주 발생하는 오류가 502 Bad Gateway입니다.
두 오류 모두 게이트웨이나 프록시 서버와 관련이 있지만 발생 원인에는 차이가 있습니다.
| 구분 | 502 Bad Gateway | 504 Gateway Timeout |
|---|---|---|
| 오류 의미 | 상위 서버에서 유효하지 않은 응답을 받음 | 상위 서버의 응답을 제한 시간 내 받지 못함 |
| 대표 원인 | 잘못된 응답, 서버 간 통신 문제 | 서버 응답 지연, 타임아웃 |
| 해결 방향 | 서버 연결과 응답 상태 확인 | 응답 지연 원인과 서버 성능 확인 |
쉽게 말하면 502 오류는 상위 서버의 응답이 잘못된 경우, 504 오류는 필요한 응답이 제시간에 도착하지 않은 경우라고 이해하면 됩니다.
504 Gateway Timeout이 SEO에 미치는 영향
블로그나 웹사이트를 운영한다면 504 오류가 검색엔진 최적화에 미치는 영향도 확인할 필요가 있습니다.
504 오류가 일시적으로 발생했다고 해서 검색 순위가 즉시 떨어지는 것은 아닙니다.
하지만 오류가 장기간 지속되거나 반복적으로 발생하면 검색엔진이 웹페이지를 정상적으로 크롤링하지 못할 수 있습니다.
구글 검색엔진은 서버 오류가 반복되면 크롤링 빈도를 줄일 수 있으며, 기존에 색인된 페이지도 장기간 접근할 수 없는 상태가 지속되면 검색 결과에서 제외될 가능성이 있습니다.
따라서 워드프레스나 블로그를 운영한다면 서버 오류를 가능한 한 빠르게 해결하는 것이 좋습니다.
특히 구글 서치콘솔에서 페이지 색인 상태와 크롤링 관련 오류를 함께 확인하면 도움이 됩니다.
504 Gateway Timeout 해결 방법 총정리
504 Gateway Timeout은 웹사이트가 다른 서버의 응답을 정해진 시간 안에 받지 못했을 때 발생하는 HTTP 오류입니다.
일반 사용자라면 새로고침, 다른 네트워크 접속, 브라우저 캐시 삭제 등을 통해 일시적인 접속 문제인지 확인할 수 있습니다.
반면 웹사이트 운영자라면 서버 과부하, 데이터베이스 지연, PHP-FPM 상태, 프록시 설정 등을 점검해야 합니다.
특히 워드프레스에서 504 오류가 반복된다면 플러그인과 서버 자원 사용량을 확인하고 필요한 경우 호스팅 업체에 문의하는 것이 좋습니다.
무엇보다 중요한 것은 504 오류가 발생했다고 해서 무조건 타임아웃 설정을 늘리는 것이 아니라 실제 응답 지연 원인을 찾아 해결해야 한다는 점입니다.
일시적인 오류라면 시간이 지나면서 정상화될 수 있지만, 반복적으로 발생한다면 서버 로그를 확인해 근본적인 원인을 해결하는 것이 중요합니다.