1. 홈
  2. 개발자
  3. HTTP 상태 코드

HTTP 상태 코드

404·500 같은 HTTP 상태 코드의 뜻과 해결 방법을 찾아봅니다.

내 브라우저에서 처리 · 업로드 없음
숫자는 앞자리부터 일치하고, 이름·설명은 한국어와 영어 모두 검색해요.

1xx 정보 (4개)

100계속Continue

요청 헤더를 잘 받았으니 본문을 이어서 보내도 된다는 임시 응답입니다.

이럴 때 보여요
클라이언트가 `Expect: 100-continue` 헤더로 큰 본문을 보내기 전에 서버의 허락을 구할 때 볼 수 있어요.
RFC 9110 §15.2.1
101프로토콜 전환Switching Protocols

서버가 `Upgrade` 요청을 받아들여 이 연결의 프로토콜을 바꿉니다.

이럴 때 보여요
WebSocket 연결을 맺을 때 HTTP 연결이 WebSocket 으로 전환돼요.
RFC 9110 §15.2.2
102처리 중Processing

서버가 요청을 받아 처리하고 있지만 아직 최종 응답이 없다는 임시 응답입니다. RFC 4918 에서는 빠졌고 지금은 거의 쓰이지 않아요.

이럴 때 보여요
오래 걸리는 WebDAV 요청에서 연결이 끊기지 않게 할 때 쓰였어요.
RFC 2518 §10.1
103사전 힌트Early Hints

최종 응답 전에 `Link` 헤더로 미리 불러올 자원(CSS·JS 등)을 알려 줍니다.

이럴 때 보여요
서버가 페이지를 만드는 동안 브라우저가 필요한 파일을 먼저 받게 할 때 써요.
RFC 8297 §2

2xx 성공 (10개)

200성공OK

요청이 성공했고 응답 본문에 결과가 들어 있습니다. 구체적인 의미는 메서드에 따라 달라요(GET 은 자원, POST 는 처리 결과).

이럴 때 보여요
정상적인 페이지 열기와 API 호출 대부분.
RFC 9110 §15.3.1 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
201생성됨Created

요청이 성공해 새 자원이 만들어졌습니다. 보통 `Location` 헤더에 새 자원의 주소를 담아요.

이럴 때 보여요
POST 로 글이나 계정 같은 새 데이터를 만들 때.
RFC 9110 §15.3.2
202접수됨Accepted

요청은 받았지만 처리는 아직 끝나지 않았습니다. 나중에 실제로 처리될지는 보장하지 않아요.

이럴 때 보여요
대용량 변환이나 메일 발송 같은 비동기 작업을 큐에 넣었을 때.
RFC 9110 §15.3.3
203신뢰할 수 없는 정보Non-Authoritative Information

요청은 성공했지만 응답이 원 서버가 아니라 프록시가 변형한 사본일 수 있습니다.

이럴 때 보여요
내용을 변환하는 프록시를 거친 응답.
RFC 9110 §15.3.4 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
204내용 없음No Content

요청은 성공했지만 보낼 본문이 없습니다. 화면을 바꾸지 않고 처리만 끝낼 때 써요.

이럴 때 보여요
DELETE·PUT 성공 응답, 자동 저장 API, CORS preflight 응답.
RFC 9110 §15.3.5 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
205내용 초기화Reset Content

요청이 성공했으니 입력 양식 같은 화면을 초기 상태로 되돌리라는 뜻입니다. 본문은 없어요.

이럴 때 보여요
폼 제출 뒤 입력칸을 비우게 하고 싶을 때. 실제로는 거의 쓰지 않아요.
RFC 9110 §15.3.6
206부분 내용Partial Content

`Range` 헤더로 요청한 일부 바이트만 보냈습니다.

이럴 때 보여요
동영상 탐색, 이어받기, 큰 파일 나눠 받기.
RFC 9110 §15.3.7 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
207다중 상태Multi-Status

여러 자원에 대한 개별 결과를 XML 본문 하나에 담아 보냅니다.

이럴 때 보여요
WebDAV 에서 여러 파일을 한 번에 처리할 때.
RFC 4918 §11.1
208이미 보고됨Already Reported

WebDAV 에서 같은 `207` 응답 안에 이미 한 번 나열한 항목이라 다시 나열하지 않는다는 뜻입니다.

이럴 때 보여요
`207` 응답에서 중복 항목을 생략할 때.
RFC 5842 §7.1
226IM 사용됨IM Used

서버가 GET 요청에 대해 델타 인코딩(RFC 3229)을 적용한 결과를 보냈습니다.

이럴 때 보여요
델타 인코딩을 지원하는 특수한 환경. 일반 웹에서는 거의 볼 수 없어요.
RFC 3229 §10.4.1

3xx 리다이렉트 (9개)

300여러 선택지Multiple Choices

요청한 자원에 선택지가 여러 개 있다는 뜻입니다. 서버가 선호하는 선택지는 `Location` 으로 알릴 수 있지만 표준화된 선택 방식은 없어요.

이럴 때 보여요
거의 쓰이지 않습니다.
RFC 9110 §15.4.1 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
301영구 이동Moved Permanently

자원이 새 주소로 영구히 옮겨졌습니다. 앞으로는 `Location` 의 주소를 쓰세요. 클라이언트가 POST 를 GET 으로 바꿔 다시 요청할 수 있어요.

이럴 때 보여요
http 에서 https 로의 전환, 도메인 이전, URL 구조 변경.
RFC 9110 §15.4.2 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
302임시 이동Found

자원이 일시적으로 다른 주소에 있습니다. 원래 주소를 계속 쓰세요. 역사적 이유로 POST 가 GET 으로 바뀔 수 있어요.

이럴 때 보여요
로그인 뒤 이동, 임시 점검 페이지로 보내기.
RFC 9110 §15.4.3
303다른 주소 참조See Other

요청 처리 결과를 `Location` 의 주소에서 GET 으로 확인하라는 뜻입니다.

이럴 때 보여요
POST-Redirect-GET 패턴: 폼 제출 뒤 결과 페이지로 보내 새로고침 중복 제출을 막을 때.
RFC 9110 §15.4.4
304수정되지 않음Not Modified

조건부 요청(`If-None-Match`, `If-Modified-Since`)에서 자원이 바뀌지 않았으니 캐시한 사본을 쓰라는 뜻입니다. 본문은 없어요.

이럴 때 보여요
브라우저가 캐시를 재검증할 때. 전송량을 아껴 줘요.
RFC 9110 §15.4.5
305프록시 사용Use Proxy

`Location` 의 프록시를 통해 접근하라는 뜻이었지만 보안 문제로 RFC 9110 에서 사용 중단(deprecated)됐습니다.

이럴 때 보여요
지금은 쓰지 않으며 브라우저도 무시해요.
RFC 9110 §15.4.6
306(사용 안 함)(Unused)

과거 초안에서 쓰였다가 예약만 남은 코드입니다. 지금은 사용하지 않습니다.

이럴 때 보여요
볼 일이 없어요.
RFC 9110 §15.4.7
307임시 리다이렉트Temporary Redirect

302 와 같지만 요청 메서드와 본문을 그대로 유지한 채 다른 주소로 다시 요청해야 합니다.

이럴 때 보여요
POST 요청을 임시로 다른 URL 로 보낼 때. HSTS 가 켜진 사이트에서 브라우저가 스스로 http 를 https 로 바꿀 때도 307(Internal Redirect)로 표시돼요.
RFC 9110 §15.4.8
308영구 리다이렉트Permanent Redirect

301 과 같은 영구 이동이지만 요청 메서드와 본문을 바꾸지 않습니다.

이럴 때 보여요
POST·PUT 요청도 새 주소로 그대로 보내야 하는 영구 이전.
RFC 9110 §15.4.9 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).

4xx 클라이언트 오류 (31개)

400잘못된 요청Bad Request

요청 문법이 잘못됐거나 서버가 이해할 수 없어 처리하지 않습니다. 클라이언트 쪽 오류로 간주돼요.

이럴 때 보여요
깨진 JSON, 잘못된 쿼리 문자열, 너무 커진 쿠키.
해결 방법
방문자: 페이지를 새로고침하고, 계속되면 사이트 쿠키를 지워 보세요.
개발자: 요청 본문과 헤더 형식을 검증하고 오류 이유를 응답 본문에 알려 주세요.
RFC 9110 §15.5.1
401인증 필요Unauthorized

유효한 인증 정보가 없어 요청이 거부됐습니다. 응답의 `WWW-Authenticate` 헤더로 인증 방식을 알려야 해요. 이름과 달리 인증(authentication) 문제입니다.

이럴 때 보여요
로그인하지 않았거나 토큰이 만료됐거나 잘못됐을 때.
해결 방법
방문자: 로그인하거나 다시 로그인하세요.
개발자: `WWW-Authenticate` 헤더를 함께 보내고 토큰 만료를 확인하세요. 로그인은 했지만 권한이 없으면 403 을 쓰세요.
RFC 9110 §15.5.2
402결제 필요Payment Required

나중을 위해 예약된 코드로, 표준 의미는 정해지지 않았습니다.

이럴 때 보여요
일부 결제·구독 API 가 한도 초과나 미결제를 알릴 때 임의로 써요.
RFC 9110 §15.5.3
403접근 금지Forbidden

서버가 요청을 이해했지만 권한이 없어 거부합니다. 다시 인증해도 결과는 달라지지 않아요.

이럴 때 보여요
로그인했지만 권한이 없는 페이지, IP 차단, 디렉터리 목록 금지.
해결 방법
방문자: 권한이 있는 계정으로 로그인했는지 확인하고 관리자에게 문의하세요.
개발자: 권한 정책, IP 허용 목록, 파일 권한을 확인하세요. 자원의 존재를 숨기려면 404 를 쓸 수도 있어요.
RFC 9110 §15.5.4
404찾을 수 없음Not Found

서버가 요청한 자원을 찾지 못했습니다. 일시적인지 영구적인지는 알려 주지 않아요.

이럴 때 보여요
잘못된 URL, 삭제된 페이지, 주소 오타.
해결 방법
방문자: 주소 오타를 확인하거나 사이트 검색을 이용하세요.
개발자: 링크와 라우트를 점검하고, 옮긴 페이지는 301·308 로 연결하세요. 없는 페이지에 200 을 주는 soft 404 는 피하세요.
RFC 9110 §15.5.5 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
405허용되지 않는 메서드Method Not Allowed

자원이 그 HTTP 메서드를 지원하지 않습니다. 응답에 허용되는 메서드를 `Allow` 헤더로 알려야 해요.

이럴 때 보여요
GET 전용 주소에 POST, 읽기 전용 API 에 DELETE.
해결 방법
방문자: 주소가 올바른지 확인하고 다른 경로로 접속해 보세요.
개발자: `Allow` 헤더에 허용 메서드를 담고 라우트의 메서드 설정을 확인하세요.
RFC 9110 §15.5.6 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
406허용되지 않는 형식Not Acceptable

`Accept` 계열 헤더 조건에 맞는 표현을 서버가 만들 수 없습니다.

이럴 때 보여요
`Accept: application/xml` 만 요청했는데 서버가 JSON 만 제공할 때.
RFC 9110 §15.5.7
407프록시 인증 필요Proxy Authentication Required

401 과 비슷하지만 프록시 서버에 대한 인증이 필요합니다. 응답에 `Proxy-Authenticate` 헤더가 있어요.

이럴 때 보여요
회사나 학교 프록시를 거치는 환경.
RFC 9110 §15.5.8
408요청 시간 초과Request Timeout

서버가 기다리던 요청을 정해진 시간 안에 다 받지 못해 연결을 닫습니다. 클라이언트는 같은 요청을 다시 보낼 수 있어요.

이럴 때 보여요
느린 네트워크에서 요청을 보내다 멈췄을 때, 오래 놀고 있던 연결.
해결 방법
방문자: 네트워크를 확인하고 다시 시도하세요.
개발자: 서버의 요청 타임아웃과 프록시 설정을 점검하세요.
RFC 9110 §15.5.9 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
409충돌Conflict

자원의 현재 상태와 충돌해 요청을 처리할 수 없습니다. 충돌을 해결한 뒤 다시 보낼 수 있어요.

이럴 때 보여요
중복 가입, 동시에 수정한 버전 충돌, 이미 처리된 상태 변경.
해결 방법
방문자: 화면을 새로고침해 최신 내용을 확인하세요.
개발자: 충돌 이유를 본문에 설명하고, ETag 비교로 동시 수정을 감지하세요.
RFC 9110 §15.5.10
410영구 삭제됨Gone

자원이 더 이상 없고 다른 주소도 없다는 것을 서버가 알고 있습니다. 404 보다 의도가 분명해요.

이럴 때 보여요
의도적으로 삭제한 페이지, 종료된 이벤트.
해결 방법
방문자: 다른 곳에서 정보를 찾아야 해요.
개발자: 삭제가 의도적이고 영구적임을 분명히 알릴 때 쓰세요.
RFC 9110 §15.5.11 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
411길이 필요Length Required

요청에 `Content-Length` 가 필요하다고 서버가 요구합니다.

이럴 때 보여요
chunked 전송을 받지 않는 서버에 본문 길이 없이 요청할 때.
RFC 9110 §15.5.12
412사전 조건 실패Precondition Failed

`If-Match` 같은 요청 헤더의 조건이 서버 상태와 맞지 않아 처리하지 않았습니다.

이럴 때 보여요
ETag 가 달라진 자원을 `If-Match` 로 수정하려 할 때(낙관적 잠금).
RFC 9110 §15.5.13
413내용이 너무 큼Content Too Large

요청 본문이 서버가 처리할 수 있는 한도를 넘었습니다. 예전 이름은 Payload Too Large 입니다.

이럴 때 보여요
업로드 용량 제한 초과(nginx 의 `client_max_body_size` 등).
해결 방법
방문자: 파일 크기를 줄여서 다시 올리세요.
개발자: 서버와 프록시의 업로드 한도를 확인하고 화면에 최대 크기를 안내하세요.
RFC 9110 §15.5.14
414URI 가 너무 김URI Too Long

URI 가 서버가 처리하는 길이보다 깁니다.

이럴 때 보여요
GET 쿼리에 데이터를 너무 많이 넣었을 때, 리다이렉트 루프로 URL 이 계속 길어질 때.
해결 방법
방문자: 주소를 줄이거나 처음부터 다시 접속하세요.
개발자: 긴 데이터는 POST 본문으로 보내고 리다이렉트 루프가 없는지 확인하세요.
RFC 9110 §15.5.15 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
415지원하지 않는 미디어 형식Unsupported Media Type

요청 본문의 형식(`Content-Type`)이나 인코딩을 서버가 지원하지 않습니다.

이럴 때 보여요
JSON 만 받는 API 에 `text/plain` 으로 보낼 때.
해결 방법
방문자: 지원하는 파일 형식인지 확인하세요.
개발자: `Content-Type` 헤더가 본문 형식과 맞는지 확인하세요.
RFC 9110 §15.5.16
416범위 만족 불가Range Not Satisfiable

`Range` 가 자원의 크기를 벗어나 줄 수 있는 범위가 없습니다.

이럴 때 보여요
이어받기 위치가 실제 파일 크기보다 클 때.
RFC 9110 §15.5.17
417기대 실패Expectation Failed

`Expect` 헤더의 기대를 서버가 충족할 수 없습니다.

이럴 때 보여요
`Expect: 100-continue` 를 이해하지 못하는 서버나 프록시.
RFC 9110 §15.5.18
418나는 찻주전자I'm a teapot

RFC 2324(하이퍼텍스트 커피 포트 제어 규약, 1998년 만우절 농담)에 나온 코드로, 찻주전자라서 커피를 끓일 수 없다는 뜻입니다. RFC 9110 과 IANA 에는 사용 안 함(Unused)으로 예약돼 있어요.

이럴 때 보여요
재미로 넣는 이스터 에그, 또는 일부 서비스가 봇을 거부할 때 임의로 써요.
RFC 2324 §2.3.2
421잘못 전달된 요청Misdirected Request

요청이 응답을 만들 수 없는 서버로 잘못 전달됐습니다.

이럴 때 보여요
HTTP/2 연결을 재사용하다 다른 호스트의 요청이 섞일 때, SNI 와 Host 가 맞지 않을 때.
RFC 9110 §15.5.20
422처리할 수 없는 내용Unprocessable Content

문법은 맞지만 의미상 처리할 수 없는 내용입니다. 예전 이름은 Unprocessable Entity 입니다.

이럴 때 보여요
유효성 검사 실패(이메일 형식 오류, 필수 필드 누락)를 알리는 API.
해결 방법
방문자: 입력한 값을 확인하세요.
개발자: 필드별 오류를 본문에 담아 사용자가 고칠 수 있게 하세요.
RFC 9110 §15.5.21
423잠김Locked

WebDAV 에서 접근하려는 자원이 잠겨 있습니다.

이럴 때 보여요
다른 사용자가 편집 중인 파일.
RFC 4918 §11.3
424의존성 실패Failed Dependency

다른 요청이 실패해서 이 요청도 처리하지 못했습니다(WebDAV).

이럴 때 보여요
한 번에 여러 작업을 보냈는데 앞선 작업이 실패했을 때.
RFC 4918 §11.4
425너무 이른 요청Too Early

TLS 1.3 early data(0-RTT)로 온 요청은 재전송 공격 위험이 있어 서버가 처리를 미룹니다. 핸드셰이크가 끝난 뒤 다시 보내면 돼요.

이럴 때 보여요
0-RTT 를 쓰는 CDN·서버 뒤에서 안전하지 않은 요청이 early data 로 도착했을 때.
RFC 8470 §5.2 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
426업그레이드 필요Upgrade Required

현재 프로토콜로는 처리할 수 없으니 `Upgrade` 헤더에 적은 프로토콜로 바꿔 다시 요청하라는 뜻입니다.

이럴 때 보여요
서버가 더 높은 버전의 프로토콜(예: TLS)을 요구할 때.
RFC 9110 §15.5.22
428사전 조건 필요Precondition Required

서버가 요청에 조건 헤더(`If-Match` 등)를 요구합니다. 동시 수정으로 덮어쓰는 사고를 막기 위해서예요.

이럴 때 보여요
ETag 없이 자원을 수정하려 할 때.
RFC 6585 §3
429요청 너무 많음Too Many Requests

정해진 시간에 너무 많은 요청을 보냈습니다. `Retry-After` 헤더로 기다릴 시간을 알릴 수 있어요.

이럴 때 보여요
API 호출 한도 초과, 로그인 시도 제한, 크롤러 제한.
해결 방법
방문자: 잠시 기다렸다가 다시 시도하세요.
개발자: `Retry-After` 를 지키고 지수 백오프로 재시도하세요. 서버에서는 남은 한도를 헤더로 안내하세요.
RFC 6585 §4 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
431요청 헤더가 너무 큼Request Header Fields Too Large

요청 헤더 전체 또는 일부 헤더가 너무 큽니다.

이럴 때 보여요
쿠키가 쌓여 헤더가 커졌을 때.
해결 방법
방문자: 해당 사이트의 쿠키를 지우세요.
개발자: 쿠키 크기를 줄이거나 서버의 헤더 한도를 점검하세요.
RFC 6585 §5
444응답 없음No Response(비표준 · nginx)

nginx 가 응답을 보내지 않고 연결을 닫을 때 로그에 남기는 내부 코드입니다. 클라이언트에는 전달되지 않아요.

이럴 때 보여요
`return 444;` 로 악성 요청을 조용히 끊을 때.
표준(IANA)에 등록되지 않은 코드예요.
451법적 사유로 이용 불가Unavailable For Legal Reasons

법적 요구(검열·판결 등)로 자원을 제공할 수 없습니다. 소설 〈화씨 451〉에서 따온 번호예요.

이럴 때 보여요
법원 명령이나 정부 차단으로 접근이 막힌 콘텐츠.
RFC 7725 §3
499클라이언트가 연결 종료Client Closed Request(비표준 · nginx)

서버가 응답하기 전에 클라이언트가 연결을 닫았을 때 nginx 가 로그에 남기는 코드입니다.

이럴 때 보여요
사용자가 페이지를 닫았거나 클라이언트 타임아웃이 먼저 지났을 때.
표준(IANA)에 등록되지 않은 코드예요.

5xx 서버 오류 (18개)

500서버 내부 오류Internal Server Error

서버가 요청을 처리하다 예기치 못한 오류를 만났습니다. 가장 일반적인 서버 오류 코드예요.

이럴 때 보여요
코드 예외, 설정 오류, DB 연결 실패.
해결 방법
방문자: 잠시 후 다시 시도하고, 계속되면 사이트 운영자에게 알려 주세요.
개발자: 서버 로그의 오류 내용을 확인하세요. 응답에 내부 정보나 스택 트레이스를 노출하지 마세요.
RFC 9110 §15.6.1
501구현되지 않음Not Implemented

서버가 요청한 메서드나 기능을 지원하지 않습니다. 나중에 지원할 수도 있다는 뜻이에요.

이럴 때 보여요
서버가 모르는 HTTP 메서드를 받았을 때.
해결 방법
방문자: 다른 방법이나 다른 서비스를 이용해 보세요.
개발자: 메서드를 구현하거나 지원하는 메서드만 쓰세요. 메서드는 알지만 그 자원에서 금지한다면 405 입니다.
RFC 9110 §15.6.2 · 별도 설정이 없어도 캐시할 수 있는 응답이에요(RFC 9110).
502잘못된 게이트웨이Bad Gateway

게이트웨이나 프록시가 상위 서버에서 잘못된 응답을 받았습니다.

이럴 때 보여요
리버스 프록시(nginx 등) 뒤의 앱 서버가 죽었거나 응답이 깨졌을 때.
해결 방법
방문자: 잠시 후 새로고침하세요.
개발자: 프록시 뒤 앱 서버의 상태와 로그, 업스트림 주소 설정을 확인하세요.
RFC 9110 §15.6.3 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
503서비스 이용 불가Service Unavailable

서버가 과부하이거나 점검 중이라 지금은 요청을 처리할 수 없습니다. `Retry-After` 로 복구 시점을 알릴 수 있어요.

이럴 때 보여요
점검, 트래픽 폭주, 배포 중 일시 중단.
해결 방법
방문자: 잠시 후 다시 시도하세요.
개발자: 점검 때는 503 과 `Retry-After` 를 보내 일시적 중단임을 알리세요.
RFC 9110 §15.6.4 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
504게이트웨이 시간 초과Gateway Timeout

게이트웨이나 프록시가 상위 서버의 응답을 기다리다 시간이 초과됐습니다.

이럴 때 보여요
느린 쿼리나 외부 API 지연으로 프록시 타임아웃을 넘었을 때.
해결 방법
방문자: 잠시 후 다시 시도하세요.
개발자: 느린 처리를 최적화하거나 프록시 타임아웃을 조정하세요. 오래 걸리는 작업은 202 로 비동기 처리하세요.
RFC 9110 §15.6.5 · 시간이 지난 뒤 다시 시도하면 성공할 수 있어요.
505HTTP 버전 미지원HTTP Version Not Supported

요청에 쓴 HTTP 버전을 서버가 지원하지 않습니다.

이럴 때 보여요
아주 오래된 서버에 최신 HTTP 버전으로 요청하거나 요청 줄이 잘못됐을 때.
RFC 9110 §15.6.6
506변형도 협상함Variant Also Negotiates

투명한 콘텐츠 협상 설정이 잘못돼 서버가 순환 참조에 빠졌습니다.

이럴 때 보여요
거의 볼 수 없는 서버 설정 오류.
RFC 2295 §8.1
507저장 공간 부족Insufficient Storage

서버의 저장 공간이 부족해 요청을 완료할 수 없습니다(WebDAV).

이럴 때 보여요
디스크가 가득 차 파일을 저장하지 못할 때.
RFC 4918 §11.5
508루프 감지Loop Detected

WebDAV 처리 중 무한 루프를 발견해 요청을 중단했습니다.

이럴 때 보여요
자기 자신을 포함하는 컬렉션을 처리할 때.
RFC 5842 §7.2
510확장 필요Not Extended

HTTP 확장 프레임워크(RFC 2774)에서 필요한 확장이 요청에 없습니다. 지금은 거의 쓰이지 않아요.

이럴 때 보여요
볼 일이 거의 없어요.
RFC 2774 §7
511네트워크 인증 필요Network Authentication Required

네트워크에 접속하려면 먼저 인증이 필요합니다.

이럴 때 보여요
공용 Wi-Fi 의 로그인 페이지(캡티브 포털)가 요청을 가로챌 때.
해결 방법
방문자: 브라우저에서 Wi-Fi 로그인 페이지에 접속해 인증하세요.
개발자: 캡티브 포털은 가로챈 요청에 200 대신 511 을 보내 클라이언트가 알아차리게 하세요.
RFC 6585 §6
520웹 서버가 알 수 없는 오류 반환Web Server Returned an Unknown Error(비표준 · Cloudflare)

Cloudflare 가 원본 서버에서 예상 밖의 응답을 받았습니다.

이럴 때 보여요
원본 서버가 충돌하거나 빈 응답·잘못된 헤더를 보낼 때.
해결 방법
방문자: 잠시 후 다시 시도하고, 계속되면 사이트 운영자에게 알려 주세요.
개발자: 원본 서버 로그와 응답 헤더 크기를 확인하세요.
표준(IANA)에 등록되지 않은 코드예요.
521웹 서버 다운Web Server Is Down(비표준 · Cloudflare)

Cloudflare 가 원본 서버에 연결을 거부당했습니다.

이럴 때 보여요
원본 서버가 꺼졌거나 방화벽이 Cloudflare IP 를 막을 때.
해결 방법
방문자: 사이트 운영자가 복구할 때까지 기다리세요.
개발자: 원본 서버가 켜져 있는지, 방화벽이 Cloudflare IP 를 허용하는지 확인하세요.
표준(IANA)에 등록되지 않은 코드예요.
522연결 시간 초과Connection Timed Out(비표준 · Cloudflare)

Cloudflare 가 원본 서버와 TCP 연결을 맺지 못했습니다.

이럴 때 보여요
원본이 과부하이거나 네트워크 경로·방화벽에 문제가 있을 때.
해결 방법
방문자: 잠시 후 다시 시도하세요.
개발자: 원본 서버 부하와 방화벽 규칙, 네트워크 경로를 확인하세요.
표준(IANA)에 등록되지 않은 코드예요.
523원본에 도달할 수 없음Origin Is Unreachable(비표준 · Cloudflare)

Cloudflare 가 원본 서버까지 가는 경로를 찾지 못했습니다.

이럴 때 보여요
DNS 에 등록된 원본 IP 가 틀렸거나 라우팅에 문제가 있을 때.
표준(IANA)에 등록되지 않은 코드예요.
524시간 초과 발생A Timeout Occurred(비표준 · Cloudflare)

Cloudflare 가 원본과 연결은 맺었지만 제한 시간(기본 100초) 안에 응답을 받지 못했습니다.

이럴 때 보여요
아주 오래 걸리는 요청.
해결 방법
방문자: 잠시 후 다시 시도하세요.
개발자: 오래 걸리는 작업은 비동기로 처리하세요.
표준(IANA)에 등록되지 않은 코드예요.
525SSL 핸드셰이크 실패SSL Handshake Failed(비표준 · Cloudflare)

Cloudflare 와 원본 서버 사이의 SSL/TLS 핸드셰이크가 실패했습니다.

이럴 때 보여요
원본이 TLS 를 지원하지 않거나 암호 설정이 맞지 않을 때.
표준(IANA)에 등록되지 않은 코드예요.
526잘못된 SSL 인증서Invalid SSL Certificate(비표준 · Cloudflare)

Cloudflare 가 원본 서버의 SSL 인증서를 검증하지 못했습니다.

이럴 때 보여요
Full (strict) 모드에서 원본 인증서가 만료됐거나 자체 서명일 때.
표준(IANA)에 등록되지 않은 코드예요.

사용 방법

  1. 검색칸에 코드 번호(404), 앞자리(40), 분류(4xx), 영어 이름(not found), 한국어 단어(리다이렉트) 중 하나를 입력합니다. 입력하지 않으면 분류별로 전체 목록이 나옵니다.
  2. 위쪽 분류 버튼(1xx–5xx)으로 목록을 좁힐 수 있습니다.
  3. 코드를 누르면 의미, 이럴 때 보여요, 해결 방법(방문자·개발자), 근거 RFC가 펼쳐집니다.
  4. 링크 복사를 누르면 #404처럼 해당 코드가 바로 열리는 주소가 복사됩니다. 팀 문서나 이슈에 붙여 넣기 좋아요.

분류별 개요

분류 의미 이 도구의 코드 수
1xx 정보: 요청을 받았고 처리를 계속하는 중인 임시 응답 4
2xx 성공: 요청을 받아 처리했음 10
3xx 리다이렉트: 요청을 끝내려면 다른 동작이 더 필요함 9
4xx 클라이언트 오류: 요청 자체에 문제가 있음 31
5xx 서버 오류: 서버가 올바른 요청을 처리하지 못함 18

표준(IANA 레지스트리) 코드와 함께 자주 보는 비표준 코드(nginx 444·499, Cloudflare 520–526)가 들어 있고, 비표준 코드에는 출처가 표시됩니다. 뜻과 이름은 RFC 9110(HTTP Semantics)을 기준으로 했습니다. 413은 예전의 Payload Too Large가 지금은 Content Too Large이고, 422도 Unprocessable Entity에서 Unprocessable Content로 바뀌었습니다.

자주 헷갈리는 코드

401과 403

코드 의미 로그인하면 달라지나요
401 인증이 없거나 잘못됨 (WWW-Authenticate 필요) 달라질 수 있음
403 누구인지는 알지만 권한이 없음 달라지지 않음

301, 302, 307, 308

코드 이동 메서드
301 영구 POST 가 GET 으로 바뀔 수 있음
302 임시 POST 가 GET 으로 바뀔 수 있음
307 임시 그대로 유지
308 영구 그대로 유지

폼 제출 뒤 결과 페이지로 보낼 때는 303(항상 GET)을 씁니다.

404와 410: 404는 지금 찾을 수 없다는 뜻일 뿐 영구인지 알리지 않습니다. 410은 의도적으로 영구 삭제했다는 뜻입니다.

502, 503, 504: 502는 상위 서버의 응답이 잘못됐을 때, 503은 서버가 과부하나 점검으로 처리할 수 없을 때, 504는 상위 서버가 제때 응답하지 않았을 때입니다. 세 코드 모두 프록시나 게이트웨이 뒤에서 흔히 봅니다.

SEO 관점

  • 주소를 영구히 옮길 때는 301 또는 308을 씁니다. 임시 이동인 302·307을 오래 두면 검색엔진이 옛 주소를 계속 대표 주소로 볼 수 있어요.
  • soft 404는 없는 페이지에 “찾을 수 없음” 화면을 보여 주면서 상태 코드는 200을 보내는 경우입니다. 검색엔진이 빈 페이지를 정상 페이지로 오해하므로 실제로 없는 페이지는 404나 410을 보내야 합니다.
  • 점검 때는 503과 Retry-After를 보내 일시적 중단임을 알립니다. 5xx가 오래 이어지면 색인에서 빠질 수 있어요.

다시 시도해도 되는 코드

이 도구에서는 408, 425, 429, 502, 503, 504에 “시간이 지난 뒤 다시 시도하면 성공할 수 있다”는 표시가 붙습니다. 429와 503은 Retry-After 헤더로 기다릴 시간(초 또는 날짜)을 알려 줄 수 있으니, 있으면 그 값을 지키고 없으면 지수 백오프(1초, 2초, 4초…)로 간격을 늘려 재시도하세요. 400, 401, 403, 404, 422처럼 요청 자체를 고쳐야 하는 4xx는 같은 요청을 반복해도 결과가 같습니다.

기본으로 캐시할 수 있는 코드(RFC 9110)는 200, 203, 204, 206, 300, 301, 308, 404, 405, 410, 414, 501이며, 이 도구에서 해당 항목에 표시됩니다.

418은 1998년 만우절 RFC 2324에서 나온 농담 코드로, 실제 서비스에서 쓰는 것을 권장하지 않습니다.

관련 도구: User-Agent 분석기, URL 인코더, JSON 포맷터, IP 서브넷 계산기.

이 도구는 브라우저 안에서만 동작하며 입력한 검색어는 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.