502 에러

502 에러(502 Bad Gateway)는 앞에서 요청을 받는 서버(게이트웨이)가 내는 응답이에요. 뒤쪽 앱에게서 제대로 된 답을 못 받았다는 뜻이에요. 콜센터 상담원(nginx)이 담당 부서(앱)에 전화를 돌렸는데 아무도 안 받는 상황이에요. 상담원은 멀쩡하니 전화는 받지만 "지금 연결이 안 돼요"라고 답해요.

502 에러는 왜 생겨요?

직접 502 를 만들어 봤어요

2026년 10월 29일, 우리 PC 의 도커에 nginx 와 뒤쪽 앱(Node.js, PHP-FPM)을 띄우고 일부러 망가뜨렸어요. nginx 설정에서 볼 곳은 여기예요.

location /app/ {
    proxy_pass http://backend:3000/;   # 뒤쪽 앱으로 넘김
    proxy_connect_timeout 3s;
    proxy_read_timeout 3s;              # 3초 안에 답 없으면 포기
}

① 앱 컨테이너는 켜져 있는데 앱 프로그램이 안 떠 있을 때는 바로 502 가 났어요.

$ curl -s -o /dev/null -w '%{http_code} %{time_total}s' http://127.0.0.1:18924/app/ok
502 0.002352s

# nginx 오류 로그
[error] connect() failed (111: Connection refused) while connecting to upstream,
request: "GET /app/ok HTTP/1.1", upstream: "http://172.20.0.2:3000/ok"
[error] connect() failed (111: Connection refused) while connecting to upstream,
request: "GET /ok.php HTTP/1.1", upstream: "fastcgi://172.20.0.3:9000"

"Connection refused"는 그 주소의 문을 두드렸더니 "여기 아무도 없어요"라는 답이 바로 왔다는 뜻이에요. Node 앱이든 PHP-FPM 이든 같은 문구가 찍혔어요.

② 앱이 너무 늦게 답할 때는 5초 걸리는 주소를 불렀더니 3초 기다리다 504 가 났어요.

504 3.142120s
[error] upstream timed out (110: Operation timed out) while reading response header from upstream

③ 앱 서버(컨테이너)를 통째로 내렸을 때는 502 가 날 줄 알았는데 504 였어요. 문을 두드려도 아무 답이 없으니 정해진 시간만큼 기다린 거예요. 타임아웃을 따로 정하지 않은 PHP 쪽은 기본값대로 1분 넘게(62.9초) 기다렸어요.

504 3.155972s
[error] upstream timed out (110: Operation timed out) while connecting to upstream

nginx 타임아웃을 3초로 줄여 둔 상태에서 잰 값이에요.

표로 보기

상황	응답	걸린 시간	nginx 로그에 찍힌 문구
앱 프로그램 꺼짐	502	0.002초	connect() failed (111: Connection refused)
앱이 5초 걸림	504	3.14초	upstream timed out … while reading response header
앱 서버 통째로 없음	504	3.16초(PHP 는 62.9초)	upstream timed out … while connecting

원인별 해결 순서

실습에서도 앱을 다시 띄우고 nginx -t(설정 문법 검사 통과)와 nginx -s reload 를 하자 같은 주소가 200 으로 돌아왔어요.

방문자라면 잠시 뒤 새로고침해 보세요. 배포 중 잠깐 생기는 502 가 많아요. 계속되면 사이트 쪽 문제라 운영자에게 알려 주는 수밖에 없어요.

502 와 504, 500 은 뭐가 달라요?

다시 안 나게 하려면

• 앱을 프로세스 관리자(systemd·pm2·도커 재시작 정책)로 돌려서 죽으면 자동으로 다시 뜨게 해요.
• 배포할 때 새 앱이 뜬 걸 확인한 뒤 옛 앱을 내려요. 그 사이 몇 초가 502 의 단골 원인이에요.
• 메모리가 빠듯하면 사양을 올리거나 앱 수를 줄여요.

퓨쳐인프라에서는

퓨쳐인프라 앱 호스팅은 앞단(HTTPS 주소)을 대신 맡아 줘요. 앱이 안 뜨거나 죽으면 콘솔·API 에서 앱 로그를 바로 볼 수 있어요. 502 가 보이면 로그의 마지막 줄부터 보세요. 가상서버에 nginx 를 직접 둔 경우엔 위 순서를 그대로 쓰면 돼요. 메모리가 모자라면 서버를 멈춘 뒤 사양을 바꿀 수 있어요.

가입하면 2,000원 크레딧이 들어와서 작은 서버로 이 실습을 똑같이 해 볼 수 있어요.

자주 묻는 질문

502 Bad Gateway 는 제 컴퓨터 문제인가요?

거의 아니에요. 사이트의 앞 서버와 뒤쪽 앱 사이 문제예요. 다른 기기에서도 같으면 확실해요.

Cloudflare 화면의 502 는 어디 문제예요?

CDN 이 원래 서버에서 제대로 된 답을 못 받은 거예요. 원래 서버(nginx·앱)가 살아 있는지부터 보세요.

타임아웃을 크게 늘리면 해결되나요?

504 는 줄 수 있지만 느린 원인은 그대로예요. 방문자도 그만큼 기다려요. 느린 쿼리·외부 API 를 먼저 찾으세요.

배포할 때마다 잠깐 502 가 떠요.

옛 앱을 내리고 새 앱이 뜨기 전 빈틈 때문이에요. 새 앱이 뜬 걸 확인하고 바꾸는 무중단 배포로 없앨 수 있어요.

관련 용어

500 에러 · 404 에러 · 캐시 · CDN · 프록시 · 서버란