500 에러

500 에러(500 Internal Server Error)는 서버가 요청을 처리하다 안에서 오류가 났다는 응답이에요. 식당에 주문은 잘 들어갔는데 주방에서 사고가 난 상황이에요. 손님(방문자)에게는 "죄송합니다"만 보이고, 무슨 사고인지는 주방 기록(서버 로그)에만 남아요.

500 에러는 왜 생겨요?

직접 500 을 세 번 일으켜 봤어요

2026년 10월 29일, 우리 PC 의 도커에 nginx(앞 서버), Node.js 앱, PHP-FPM 을 띄웠어요. 그리고 일부러 세 가지 오류를 만들었어요.

$ curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:18924/app/crash   # ① 앱이 직접 500 을 돌려줌
500
$ curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:18924/boom.php    # ② PHP 코드에서 예외
500
$ curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:18924/loop        # ③ nginx 설정이 무한 되돌이
500

방문자 눈에는 셋 다 똑같은 500 이에요. 원인은 각각 다른 로그에 있었어요.

# ② PHP-FPM 로그 (docker logs phpfpm)
NOTICE: PHP message: PHP Fatal error:  Uncaught Exception: database connection failed in /var/www/boom.php:3

# ③ nginx 오류 로그 (docker logs web)
[error] *13 rewrite or internal redirection cycle while processing "/loop2", request: "GET /loop HTTP/1.1"

# ① 은 앱이 스스로 500 을 보낸 거라 nginx 오류 로그엔 아무것도 없었어요 → 앱 로그를 봐야 해요

②는 "DB 연결 실패"라고 이유가 바로 찍혔어요. ③은 설정 두 줄이 서로를 가리켜 빙빙 돈 거예요.

location /loop  { rewrite ^/loop$  /loop2 last; }
location /loop2 { rewrite ^/loop2$ /loop  last; }

원인별 해결 순서

방문자라면 할 수 있는 게 많지 않아요. 몇 분 뒤 새로고침해 보고, 계속되면 사이트에 알려 주세요. 내 컴퓨터 문제인 경우는 드물어요.

운영자라면 이 순서로 봐요.

nginx 설정을 고쳤다면 nginx -t 로 문법을 먼저 확인하고 nginx -s reload 로 반영해요. 운영 화면에는 오류 내용을 그대로 보여 주지 마세요(위 실습도 display_errors=0). 공격자에게 힌트가 돼요.

500, 502, 503, 504 는 뭐가 달라요?

자주 하는 오해

• 500 은 서버가 죽었다는 뜻이다. 서버는 살아서 "오류 났어요"라고 답한 거예요. 다른 페이지는 멀쩡할 수 있어요.
• 새로고침을 계속 누르면 풀린다. 일시적인 문제가 아니면 안 풀려요. 원인은 로그에 있어요.
• 500 이면 무조건 코드 문제다. 위 실습 ③처럼 웹 서버 설정만으로도 500 이 나요.

퓨쳐인프라에서는

퓨쳐인프라 앱 호스팅에서는 콘솔이나 API 로 앱 컨테이너 로그를 바로 볼 수 있어요. 앱이 500 을 내거나 안 뜰 때 원인은 거의 항상 여기 찍혀 있어요. 가상서버에 직접 nginx 를 깔았다면 위 순서대로 로그를 보면 돼요.

위험한 설정을 바꾸기 전에는 서버 백업을 한 장 떠 두면 되돌리기 쉬워요. 가입하면 2,000원 크레딧이 들어와서 작은 서버로 먼저 연습할 수 있어요.

자주 묻는 질문

500 에러는 제 인터넷 문제인가요?

아니에요. 서버 쪽 문제예요. 다른 기기·다른 회선에서도 같으면 확실해요.

워드프레스에서 500 이 나면요?

최근에 깐 플러그인·테마부터 의심하세요. 플러그인 폴더 이름을 잠시 바꿔 꺼 보고, PHP 오류 로그를 확인해요.

500 에러가 검색 순위에 영향을 줘요?

잠깐은 괜찮지만 오래 이어지면 검색엔진이 그 페이지를 덜 찾아오고, 결국 결과에서 빠질 수 있어요. 빨리 고치는 게 좋아요.

오류 내용을 화면에 보여 주면 안 되나요?

개발할 때만 보여 주세요. 운영 화면에 경로·쿼리가 드러나면 공격에 쓰일 수 있어요. 대신 로그에 남겨요.

관련 용어

502 에러 · 404 에러 · 세션 · 캐시 · 서버란 · 스냅샷과 백업