오류 카테고리

HTTP 및 서버 오류

HTTP 5xx 응답과 연결 수준의 장애를 진단하기 위한 실용적인 가이드입니다. 원인이 브라우저, 네트워크, 프록시, 웹 서버, 애플리케이션 또는 백엔드 종속성 중 어디에 있는지 체계적으로 확인할 수 있습니다.

공개 가이드 33개실용적인 진단확인 단계

이 오류 카테고리 소개

# HTTP 및 서버 오류

HTTP 및 서버 오류는 요청을 정상적으로 완료할 수 없을 때 발생합니다. 일부 장애는 500, 502, 503, 504와 같은 HTTP 상태 코드를 반환합니다. 반면 브라우저가 HTTP 응답을 받기 전에 발생하는 장애도 있으며, 이 경우 ERR_CONNECTION_REFUSED 또는 ERR_CONNECTION_TIMED_OUT과 같은 메시지가 표시됩니다.

브라우저 메시지는 증상을 알려 주지만, 항상 어떤 구성 요소를 확인해야 하는지 알려 주는 것은 아닙니다. 먼저 장애가 발생한 경계를 찾으세요. 브라우저와 네트워크 사이인지, 네트워크와 수신 대기 서비스 사이인지, 프록시와 백엔드 사이인지, 애플리케이션과 종속성 사이인지 확인해야 합니다.

먼저 장애 유형 확인하기

HTTP 상태 코드가 반환된 경우

숫자로 된 상태 코드는 HTTP를 처리할 수 있는 구성 요소가 응답했다는 뜻입니다. 해당 구성 요소는 애플리케이션 자체가 아니라 오리진 웹 서버, 리버스 프록시, 로드 밸런서 또는 CDN일 수 있습니다.

500 Internal Server Error: 요청을 처리하는 동안 서버에서 예기치 않은 상황이 발생했습니다. 먼저 애플리케이션 로그와 웹 서버 로그를 확인하세요. [500 Internal Server Error 가이드](/http-500-internal-server-error)를 참고하세요.
502 Bad Gateway: 프록시가 백엔드에서 잘못되었거나 비어 있거나 사용할 수 없는 응답을 받았습니다. 백엔드 프로세스, 업스트림 호스트와 포트, 프록시와 오리진 사이의 연결을 확인하세요. [502 Bad Gateway 가이드](/http-502-bad-gateway)를 참고하세요.
503 Service Unavailable: 해당 시점에 서비스가 요청을 처리할 수 없습니다. 유지 관리 모드, 용량 부족, 사용할 수 없는 프로세스 또는 장애가 발생한 종속성 등이 원인일 수 있습니다. [503 Service Unavailable 가이드](/http-503-service-unavailable)를 참고하세요.
504 Gateway Timeout: 게이트웨이가 요청을 전달했지만 타임아웃이 만료되기 전에 응답을 받지 못했습니다. 백엔드가 실행 중이지만 느리거나 과부하 상태이거나 다른 서비스를 기다리고 있을 수 있습니다. [504 Gateway Timeout 가이드](/http-504-gateway-timeout)를 참고하세요.

상태 코드만으로 어떤 계층에서 장애가 발생했는지 확정할 수는 없습니다. 응답의 브랜딩, 헤더, 타임스탬프와 로그를 확인하여 응답이 오리진에서 직접 왔는지 중간 구성 요소에서 왔는지 판단하세요.

브라우저에 연결 오류가 표시되는 경우

연결 수준의 오류는 브라우저가 예상한 엔드포인트에서 정상적인 HTTP 응답을 받지 못했다는 뜻입니다.

ERR_CONNECTION_REFUSED: 대상에 도달했지만 연결이 거부되었습니다. 예상 포트에서 서비스가 수신 대기 중인지, 로컬 또는 네트워크 보안 규칙이 접근에 영향을 주는지 확인하세요. 개발 환경에서는 [localhost의 ERR_CONNECTION_REFUSED](/err-connection-refused-localhost)를 참고하세요.
ERR_CONNECTION_TIMED_OUT: 브라우저가 사용할 수 있는 응답을 받지 못한 채 대기했습니다. 애플리케이션이 생성한 HTTP 오류를 찾기 전에 네트워크 경로, 라우팅, 필터링, DNS, 서버 연결 가능 여부와 리소스 가용성을 조사하세요. [ERR_CONNECTION_TIMED_OUT 가이드](/err-connection-timed-out)를 참고하세요.

실용적인 진단 순서

1. 장애 재현 및 기록

한 번 새로 고친 다음, 같은 URL을 시크릿 창이나 다른 기기에서 열어 보세요. 정확한 URL, 오류 메시지, 상태 코드, 대략적인 발생 시간과 화면에 표시된 응답 페이지를 기록하세요. 브랜딩이 포함된 CDN 또는 프록시 페이지가 표시되면 요청이 중간 구성 요소까지 도달했다는 뜻일 수 있습니다. 반면 일반적인 브라우저 메시지는 사용할 수 있는 HTTP 응답이 도착하지 않았다는 의미일 수 있습니다.

한 브라우저나 기기에서만 실패한다면 해당 기기의 프록시, VPN, DNS 캐시, 확장 프로그램과 로컬 보안 소프트웨어를 확인하세요. 여러 기기와 네트워크에서 같은 URL이 실패한다면 서버, 프록시, 오리진 또는 공유 네트워크 경로에 문제가 있을 가능성이 커집니다.

2. 영향을 받는 범위 확인

문제가 하나의 경로, 하나의 호스트, 전체 애플리케이션 또는 전체 서비스에 영향을 주는지 확인하세요.

한 경로만 실패하면 애플리케이션 코드, 해당 경로의 종속성 또는 느린 쿼리 때문일 수 있습니다.
모든 경로에서 500이 반환되면 더 광범위한 애플리케이션 또는 서버 구성 문제일 가능성이 있습니다.
프록시를 거치는 모든 요청에서 502 또는 504가 발생하면 오리진 프로세스, 업스트림 연결 또는 프록시 구성에 주목해야 합니다.
한 포트에서 연결이 거부되면 예상된 서비스가 수신 대기 중이지 않은 상태일 수 있으며, 다른 서비스는 계속 사용 가능할 수 있습니다.

가능하면 정상적으로 작동하는 엔드포인트와 실패하는 엔드포인트를 비교하세요. 라우팅, 인증, 종속성과 배포 상태의 차이가 관련 없는 클라이언트 설정을 변경하는 것보다 더 유용한 단서를 제공할 수 있습니다.

3. 응답을 생성한 구성 요소 확인

500 오류가 발생했다면 장애 발생 시간에 맞춰 애플리케이션 로그와 웹 서버 로그를 대조하세요. 502, 503, 504 응답이라면 프록시 또는 게이트웨이 로그와 백엔드 로그를 모두 확인하세요. 중지된 프로세스, 실패한 배포, 종속성 연결 실패, 리소스 고갈 또는 관련 타임아웃을 초과한 요청이 있는지 살펴보세요.

로컬 ERR_CONNECTION_REFUSED라면 Apache 또는 Nginx가 실행 중인지, 구성된 포트를 사용할 수 있는지 확인하세요. 웹 서버가 시작되지 않았거나 다른 프로그램이 예상 포트에 바인딩하지 못하게 하는 경우 XAMPP, Laragon, MAMP에서 이러한 증상이 나타날 수 있습니다.

4. 오리진과 종속성을 পৃথ로 테스트

서비스를 관리하고 있다면 프록시 연결이 성공했다고 해서 애플리케이션이 정상이라고 단정하지 말고, 백엔드가 연결을 수락하고 간단한 엔드포인트에 응답하는지 확인하세요. 그런 다음 데이터베이스와 기타 구성된 종속성 등 필요한 서비스를 확인하세요.

살아 있지만 지속적으로 느린 백엔드는 중지되었거나 사용할 수 없는 응답을 반환하는 백엔드보다 504에 더 부합합니다. 후자의 경우 502가 발생할 수 있습니다. 서비스가 의도적으로 사용할 수 없거나 필요한 종속성을 이용할 수 없을 때는 애플리케이션 요청이 처리되기 전에 503이 발생할 수도 있습니다.

문제를 해결하는 방법으로 반복해서 새로 고치지는 마세요. 근본적인 프로세스, 종속성 또는 타임아웃 문제를 조사하는 동안 부하를 증가시킬 수 있습니다.

오류 세부 정보로 계층 찾기

응답 본문, 헤더와 타임스탬프를 확인하면 어떤 구성 요소가 장애를 처리했는지 알 수 있습니다.

일반적인 브라우저 메시지는 보통 사용할 수 있는 HTTP 응답을 받지 못했다는 뜻입니다.
브랜딩이 포함된 프록시 또는 CDN 페이지는 중간 구성 요소가 오류를 생성했거나 표시했다는 뜻입니다.
애플리케이션별 오류 페이지는 오리진 애플리케이션을 더 직접적으로 가리킬 수 있습니다.

간헐적인 장애라면 발생 시간을 배포, 트래픽 증가, 프로세스 재시작과 종속성 지연 시간에 맞춰 비교하세요. 지속적인 장애라면 서버 설정을 변경하기 전에 정상 요청과 실패 요청을 비교하고 구성 차이를 확인하세요.

Cloudflare를 사용하는 사이트에서 Cloudflare 브랜딩이 포함된 504가 발생하면 일반적으로 해당 엣지가 적용 가능한 타임아웃 시간 내에 오리진에서 응답을 받지 못했다는 뜻입니다. [Cloudflare 환경의 504 Gateway Timeout 가이드](/504-gateway-timeout-cloudflare)에서는 오리진 문제와 다른 게이트웨이 또는 오리진 자체에서 발생한 타임아웃을 구분하는 방법을 설명합니다.

지원을 요청할 때 포함할 내용

유용한 문제 보고서에는 다음 내용이 포함됩니다.

정확한 오류 메시지와 상태 코드
URL 경로와 대략적인 장애 발생 시간
다른 사용자, 기기 또는 네트워크에도 문제가 발생하는지 여부
프록시, CDN 또는 로드 밸런서가 관련되어 있는지 여부
관련 웹 서버, 프록시와 애플리케이션 로그 항목(비밀번호, 토큰 및 기타 비밀 정보는 삭제)

목표는 장애가 발생한 경계를 찾는 것입니다. 해당 경계를 파악하면 관련 오류 가이드에서 더 구체적인 확인 방법을 제공할 수 있으며, 브라우저, 네트워크, 프록시와 백엔드의 원인을 서로 동일하게 취급하지 않아도 됩니다.

가이드 라이브러리

이 카테고리의 오류 가이드

화면에 보이는 오류에서 시작해 진단과 확인 단계까지 진행하세요.

403 Forbidden 오류: 의미와 해결 방법

HTTP 403 Forbidden 응답은 서버가 요청을 이해했지만 요청한 리소스에 대한 액세스를 허용하지 않는다는 의미입니다. 계정 권한, 애플리케이션 권한 부여, 파일 권한, 웹 서버 규칙…