502 Bad Gateway 오류 원인 및 해결 방법 총정리

인터넷을 이용하다 보면 웹사이트에 접속하는 과정에서 갑자기 502 Bad Gateway라는 오류 메시지가 나타나는 경우가 있습니다.

평소 정상적으로 이용하던 사이트가 갑자기 열리지 않거나, 워드프레스 관리자 페이지에 접속할 때 502 오류가 발생하면 당황하기 쉽습니다.

특히 개인 블로그나 쇼핑몰을 운영하고 있다면 502 오류가 지속될 경우 방문자가 사이트에 접속하지 못하고 검색엔진 크롤링에도 영향을 줄 수 있습니다.

이번 글에서는 502 Bad Gateway 오류가 발생하는 원인과 해결 방법을 일반 사용자와 웹사이트 운영자 입장에서 각각 정리해 보겠습니다.

502 Bad Gateway란?

502 Bad Gateway는 게이트웨이 또는 프록시 역할을 하는 서버가 상위 서버로부터 정상적이지 않은 응답을 받았을 때 발생하는 HTTP 오류 코드입니다.

웹사이트에 접속하면 브라우저의 요청이 웹서버로 전달되고, 경우에 따라 웹서버는 다른 애플리케이션 서버나 데이터베이스와 통신합니다.

이 과정에서 중간 서버가 상위 서버로부터 유효하지 않은 응답을 받으면 502 오류가 발생할 수 있습니다.

쉽게 말하면 웹사이트의 서버끼리 통신하는 과정에서 정상적인 응답을 받지 못한 상황이라고 이해하면 됩니다.

대표적인 오류 메시지는 다음과 같습니다.

  • 502 Bad Gateway
  • HTTP Error 502
  • Error 502
  • 502 Proxy Error
  • Nginx 502 Bad Gateway

오류 화면은 Nginx, Apache, Cloudflare 등 사용하는 서버 환경에 따라 다르게 나타날 수 있습니다.

502 Bad Gateway 오류가 발생하는 원인

502 오류는 단순히 인터넷 연결이 느려서 발생하는 문제가 아닙니다.

대부분 웹서버와 상위 서버 사이의 통신 과정에서 문제가 발생했을 때 나타납니다.

1. 웹서버 또는 애플리케이션 서버 장애

가장 대표적인 원인은 웹서버나 애플리케이션 서버의 장애입니다.

예를 들어 Nginx가 PHP-FPM으로 요청을 전달하는 환경에서 PHP-FPM 프로세스가 중단되거나 정상적으로 작동하지 않으면 502 오류가 발생할 수 있습니다.

서버가 재시작되는 과정에서도 일시적으로 오류가 나타날 수 있습니다.

2. 서버 과부하

웹사이트에 갑자기 방문자가 몰리면 서버의 CPU와 메모리 사용량이 증가할 수 있습니다.

이때 애플리케이션 서버가 정상적으로 요청을 처리하지 못하거나 연결이 끊어지면 502 오류가 발생할 수 있습니다.

특히 서버 자원이 제한된 저가형 웹호스팅 환경에서는 트래픽 증가나 무거운 작업이 문제를 일으킬 수 있습니다.

3. PHP-FPM 오류

워드프레스는 PHP를 기반으로 작동하기 때문에 PHP-FPM 상태가 중요합니다.

PHP-FPM이 중단되었거나 Nginx와 연결된 소켓 경로가 잘못 설정된 경우 502 오류가 발생할 수 있습니다.

PHP 프로세스가 메모리 부족으로 강제 종료되는 상황도 확인할 필요가 있습니다.

4. 워드프레스 플러그인 및 테마 문제

워드프레스에서 플러그인이나 테마가 PHP 오류를 발생시키거나 서버 자원을 과도하게 사용하면 502 오류로 이어질 수 있습니다.

특히 최근 플러그인을 설치하거나 업데이트한 뒤 오류가 발생했다면 해당 플러그인을 확인하는 것이 좋습니다.

다만 모든 502 오류가 플러그인 때문에 발생하는 것은 아닙니다.

5. CDN 및 프록시 서버 문제

Cloudflare와 같은 CDN 서비스를 사용하는 경우 원본 서버와 CDN 사이의 통신 문제로 502 오류가 발생할 수 있습니다.

원본 서버가 비정상적인 응답을 보내거나 연결을 갑자기 종료하면 프록시 서버에서 502 오류를 표시할 수 있습니다.

502 Bad Gateway 해결 방법

502 오류를 해결하려면 먼저 일반 방문자에게 발생한 문제인지, 웹사이트 운영자가 관리해야 하는 서버 문제인지 구분하는 것이 좋습니다.

일반 사용자는 다음 방법을 순서대로 시도할 수 있습니다.

1. 웹페이지 새로고침

가장 먼저 시도할 방법은 웹페이지를 새로고침하는 것입니다.

일시적인 서버 오류라면 몇 초 또는 몇 분 후 정상적으로 접속될 수 있습니다.

Windows에서는 F5 또는 Ctrl + R을 눌러 새로고침할 수 있습니다.

다만 결제나 주문 화면에서는 중복 요청이 발생할 수 있으므로 처리 상태를 먼저 확인해야 합니다.

2. 다른 웹사이트 접속 확인

다른 웹사이트에도 접속 문제가 있는지 확인합니다.

다른 사이트는 정상적으로 열리는데 특정 사이트에서만 502 오류가 발생한다면 해당 사이트의 서버에 문제가 있을 가능성이 있습니다.

여러 사이트에서 동시에 문제가 발생한다면 인터넷 연결이나 프록시, VPN 설정도 확인해 볼 수 있습니다.

3. 브라우저 캐시 삭제

브라우저에 저장된 캐시가 오래되었거나 접속 과정에서 문제가 발생한 경우 캐시를 삭제해 볼 수 있습니다.

크롬 브라우저에서는 다음 순서로 진행합니다.

  1. 크롬 실행
  2. 오른쪽 상단 점 세 개 메뉴 선택
  3. 인터넷 사용 기록 삭제 선택
  4. 캐시된 이미지 및 파일 선택
  5. 데이터 삭제

다만 502 오류는 기본적으로 서버에서 발생하는 오류이기 때문에 캐시를 삭제한다고 반드시 해결되는 것은 아닙니다.

4. 시크릿 모드로 접속

브라우저 확장 프로그램이나 기존 쿠키 등의 영향을 확인하려면 시크릿 모드로 접속해 볼 수 있습니다.

크롬에서는 Ctrl + Shift + N을 누르면 시크릿 창을 열 수 있습니다.

시크릿 모드에서 정상적으로 접속된다면 브라우저 확장 프로그램이나 저장된 사이트 데이터 등을 확인할 필요가 있습니다.

5. VPN 및 프록시 설정 확인

VPN이나 프록시 서비스를 이용하고 있다면 일시적으로 연결을 해제한 뒤 접속해 봅니다.

특정 네트워크 경로에서만 문제가 발생하는지 확인하는 데 도움이 됩니다.

다만 원본 서버에서 발생하는 502 오류라면 네트워크를 변경해도 해결되지 않을 수 있습니다.

워드프레스 502 Bad Gateway 해결 방법

워드프레스를 운영하는 관리자라면 서버 설정과 PHP 상태를 확인하는 것이 중요합니다.

특히 관리자 페이지에 접속할 때 502 오류가 발생하거나 플러그인 업데이트 이후 문제가 발생했다면 다음 방법을 확인해 볼 수 있습니다.

1. 최근 설치한 플러그인 확인

최근 설치하거나 업데이트한 플러그인이 있다면 해당 플러그인을 우선적으로 확인합니다.

관리자 페이지에 접속할 수 있다면 플러그인을 하나씩 비활성화하면서 오류가 해결되는지 확인합니다.

관리자 페이지에도 접속할 수 없다면 SFTP 또는 호스팅 파일 관리자를 이용해 플러그인 폴더 이름을 변경하는 방법이 있습니다.

워드프레스 플러그인 경로는 일반적으로 다음과 같습니다.

wp-content/plugins

예를 들어 plugins 폴더 이름을 plugins-disabled로 변경하면 워드프레스에서 기존 플러그인들을 불러오지 못하게 할 수 있습니다.

다만 사이트 기능에 영향을 줄 수 있으므로 작업 전에 백업을 진행하는 것이 좋습니다.

2. PHP 버전 및 PHP-FPM 확인

워드프레스는 PHP를 기반으로 작동하므로 PHP 환경에 문제가 있다면 502 오류가 발생할 수 있습니다.

서버 관리 권한이 있다면 PHP-FPM 서비스가 정상적으로 실행되고 있는지 확인합니다.

리눅스 서버에서는 다음과 같은 명령어를 사용할 수 있습니다.

sudo systemctl status php8.3-fpm

위 명령어는 PHP 8.3을 사용하는 환경의 예시입니다.

실제 서버에 설치된 PHP 버전에 따라 서비스 이름이 다를 수 있습니다.

PHP-FPM이 중단되어 있다면 로그를 확인하고 원인을 파악해야 합니다.

3. 서버 메모리 사용량 확인

서버의 메모리가 부족하면 PHP 프로세스가 강제로 종료될 수 있습니다.

이 경우 웹서버가 PHP-FPM으로부터 정상적인 응답을 받지 못해 502 오류가 발생할 수 있습니다.

리눅스 서버에서는 다음 명령어로 메모리 사용량을 확인할 수 있습니다.

free -h

CPU와 메모리 사용량을 함께 확인하려면 다음 명령어도 사용할 수 있습니다.

top

서버 자원이 지속적으로 부족하다면 플러그인 최적화, 캐시 설정 개선, 서버 사양 조정 등을 검토할 수 있습니다.

4. 워드프레스 오류 로그 확인

502 오류의 원인을 정확하게 파악하려면 로그를 확인하는 것이 좋습니다.

워드프레스의 wp-config.php 파일에서 디버그 로그를 설정할 수 있습니다.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

디버그 로그가 정상적으로 기록되면 일반적으로 다음 경로에서 확인할 수 있습니다.

wp-content/debug.log

다만 PHP 실행 자체가 실패하는 경우에는 워드프레스 로그가 남지 않을 수도 있습니다.

이때는 웹서버와 PHP-FPM의 오류 로그를 함께 확인해야 합니다.

문제 해결 후에는 디버그 설정을 원래 상태로 되돌리고 로그 파일이 외부에 노출되지 않도록 관리하는 것이 좋습니다.

Nginx 502 Bad Gateway 해결 방법

Nginx를 사용하는 서버에서 502 오류가 발생했다면 상위 서버 연결 상태를 확인해야 합니다.

1. Nginx 오류 로그 확인

먼저 Nginx 오류 로그를 확인합니다.

일반적인 리눅스 환경에서는 다음 명령어를 사용할 수 있습니다.

sudo tail -n 100 /var/log/nginx/error.log

실제 로그 경로는 서버 설정에 따라 다를 수 있습니다.

오류 로그에 connect() failed 또는 upstream prematurely closed connection 등의 메시지가 나타난다면 상위 서버 연결이나 응답 처리에 문제가 있을 가능성이 있습니다.

2. PHP-FPM 소켓 경로 확인

Nginx에서 PHP-FPM으로 요청을 전달할 때 소켓 또는 TCP 연결을 사용합니다.

예를 들어 다음과 같은 설정이 있을 수 있습니다.

fastcgi_pass unix:/run/php/php8.3-fpm.sock;

실제 PHP-FPM이 사용하는 소켓 경로와 Nginx 설정이 다르면 연결에 실패할 수 있습니다.

따라서 Nginx의 fastcgi_pass 설정과 PHP-FPM의 listen 설정이 일치하는지 확인해야 합니다.

3. Nginx 설정 검사

Nginx 설정을 변경했다면 다음 명령어로 문법 오류가 없는지 확인합니다.

sudo nginx -t

설정에 문제가 없다면 다음 명령어로 설정을 다시 불러올 수 있습니다.

sudo systemctl reload nginx

단, 서버 설정을 변경하기 전에 기존 설정 파일을 백업하는 것이 좋습니다.

Cloudflare 502 Bad Gateway 해결 방법

Cloudflare를 사용하는 사이트에서 502 오류가 발생했다면 원본 서버와 Cloudflare 사이의 연결을 확인해야 합니다.

먼저 원본 서버가 정상적으로 작동하고 있는지 확인합니다.

원본 서버에서 이미 502 오류가 발생하고 있다면 Cloudflare 설정만 변경해서는 해결되지 않을 수 있습니다.

반대로 원본 서버가 정상적으로 작동하는데 Cloudflare를 통해 접속할 때만 오류가 발생한다면 프록시 설정, 방화벽, 네트워크 연결 등을 점검해야 합니다.

Cloudflare의 오류 화면이나 응답 헤더에 따라 문제를 분석하는 방법이 달라질 수 있으므로 오류가 발생한 시간과 서버 로그를 함께 확인하는 것이 좋습니다.

502 Bad Gateway와 504 Gateway Timeout 차이

502 오류와 504 오류는 비슷해 보이지만 발생 원인이 다릅니다.

구분502 Bad Gateway504 Gateway Timeout
오류 의미상위 서버의 유효하지 않은 응답상위 서버 응답 시간 초과
주요 원인서버 연결 오류, 비정상적인 응답서버 응답 지연, 타임아웃
대표 상황PHP-FPM 연결 실패백엔드 처리 시간 지연
해결 방향서버 연결 및 응답 상태 확인서버 성능 및 응답 지연 확인

쉽게 말하면 502 오류는 정상적이지 않은 응답을 받은 경우, 504 오류는 정해진 시간 안에 필요한 응답을 받지 못한 경우라고 이해하면 됩니다.

두 오류 모두 서버 간 통신 문제와 관련이 있으므로 서버 로그를 확인하는 것이 중요합니다.

502 Bad Gateway 오류 해결 방법 정리

502 Bad Gateway는 웹서버가 상위 서버로부터 정상적이지 않은 응답을 받았을 때 발생하는 HTTP 오류입니다.

일반 사용자라면 새로고침, 시크릿 모드 접속, 캐시 삭제, 네트워크 변경 등을 통해 일시적인 접속 문제인지 확인할 수 있습니다.

반면 웹사이트 운영자라면 Nginx 오류 로그, PHP-FPM 실행 상태, 서버 메모리, 워드프레스 플러그인 등을 점검해야 합니다.

특히 워드프레스에서 502 오류가 반복적으로 발생한다면 서버의 연결 상태와 PHP-FPM 오류 로그를 먼저 확인하는 것이 중요합니다.

502 오류는 단순한 브라우저 문제가 아니라 서버 간 통신 과정에서 발생하는 문제인 경우가 많기 때문입니다.

일시적인 오류라면 잠시 후 정상화될 수 있지만 반복적으로 발생한다면 서버 로그를 분석해 근본적인 원인을 해결하는 것이 가장 확실한 방법입니다.