HTTP 502 — 잘못된 게이트웨이
모든 상태 코드
무료
5xx 서버 오류: 서버가 명백히 유효한 요청을 처리하지 못했습니다.
502
5xx · 서버 오류
잘못된 게이트웨이
상위 서버가 유효하지 않은 응답을 반환했습니다.
의미
서버가 게이트웨이나 프록시로 동작하는 중에, 요청을 수행하기 위해 접근한 인바운드 서버로부터 유효하지 않은 응답을 받았습니다.
사용 시점
리버스 프록시(nginx)에서 상위 앱이 다운되거나 오류를 낼 때 흔히 발생합니다.
다른 5xx 코드
HTTP 상태 코드 소개
이 HTTP 상태 코드 디렉터리는 1xx 정보성 응답부터 5xx 서버 오류까지 모든 표준 응답 코드를 다룹니다. 각 항목에는 숫자 코드, 표준 사유 문구(reason phrase), 한 줄 요약이 표시되며, 전체 목록은 번호, 이름, 의미로 검색할 수 있어 301, Unauthorized, timeout 모두 원하는 항목을 찾아주고, 응답 클래스로 필터링할 수도 있습니다.
각 코드는 전체 설명이 담긴 전용 페이지로 연결됩니다. 상태 코드가 실제로 무엇을 의미하는지, 자신의 API와 애플리케이션에서 언제 사용해야 하는지, 해당 코드의 응답이 기본적으로 캐시 가능한지, 그리고 이를 정의한 RFC까지 확인할 수 있습니다. 같은 클래스의 관련 코드는 페이지 하단에 링크되어 있어 401과 403, 301과 308을 비교하는 데 클릭 한 번이면 충분합니다.
다섯 개 클래스는 응답을 읽는 가장 빠른 사고 모델입니다. 1xx는 요청이 계속 진행 중임을, 2xx는 성공을, 3xx는 리디렉션을, 4xx는 클라이언트 측 오류를, 5xx는 서버 실패를 의미합니다. 이 디렉터리는 정확히 이 구조를 중심으로 구성되어 있습니다.
HTTP 상태 코드 사용 방법
- 검색창에 코드, 사유 문구 또는 키워드를 입력하세요. 예: 404, Not Found 또는 redirect.
- 클래스 필터를 사용해 정보성, 성공, 리디렉션, 클라이언트 오류, 서버 오류 코드로 목록을 좁히세요.
- 각 코드의 페이지를 열어 의미, 사용 시점, 기본 캐시 가능 여부, 정의된 RFC를 확인하세요.
- 관련 코드 섹션을 확인해 같은 클래스의 이웃 코드를 비교하세요.
- 복사 버튼을 사용해 버그 리포트, 테스트, API 명세에 사용할 코드를 가져오세요.
자주 묻는 질문
첫 번째 자릿수는 결과에 따라 코드를 분류합니다. 1xx는 정보성(요청을 받았으니 계속 진행), 2xx는 성공, 3xx는 리디렉션(추가 조치 필요), 4xx는 클라이언트 오류(요청 측의 잘못), 5xx는 서버 오류(서버가 유효한 요청을 처리하지 못함)를 나타냅니다.
401 Unauthorized는 요청에 유효한 인증 정보가 없다는 뜻으로, 클라이언트는 로그인하거나 자격 증명을 제공해 다시 시도해야 합니다. 403 Forbidden은 서버가 자격 증명을 이해했지만 그래도 접근을 거부한다는 뜻으로, 인증을 해도 결과는 바뀌지 않습니다.
리소스가 영구적으로 이동했다면 301을 사용하세요. 브라우저와 검색 엔진이 참조를 업데이트합니다. 임시 이동이라면 302를 사용하세요. 요청 메서드를 정확히 유지해야 한다면 더 엄격한 최신 대응 코드인 308과 307을 선호하세요.
200이나 301 같은 일부 상태 코드는 명시적인 캐시 헤더가 없어도 브라우저와 프록시 캐시에 저장될 수 있지만, 대부분의 4xx와 5xx 응답 같은 다른 코드는 그렇지 않습니다. 이 플래그는 기본값을 알려줘서 언제 Cache-Control 헤더가 필요한지 알 수 있게 해줍니다.
네. 각 코드는 의미, 일반적인 용도, 캐시 가능 여부, 정의된 RFC와 함께 같은 클래스의 관련 코드까지 담은 전용 링크 가능한 페이지를 갖고 있어, 논의 중인 정확한 코드를 북마크하거나 공유하기 편리합니다.
네. 디렉터리와 각 코드 페이지 모두 계정 없이 무료로 볼 수 있으며, 검색은 서버로 아무것도 전송하지 않고 브라우저에서 즉시 실행됩니다.
도움이 필요하신가요?
이 도구에서 문제를 발견하셨나요? 저희 팀에 알려주세요.