HTTP 상태 코드

100 Continue 표준

중간 응답: 클라이언트가 Expect: 100-continue 로 알린 본문을 받겠다는 뜻입니다.

흔한 원인 curl 같은 클라이언트가 큰 본문을 올리기 전에 Expect: 100-continue 를 보냅니다.

RFC 9110 15.2.1

101 Switching Protocols 표준

서버가 Upgrade 헤더의 프로토콜로 바꿉니다.

흔한 원인 웹소켓 연결 시작(Upgrade: websocket).

nginx

웹소켓을 프록시하려면 proxy_http_version 1.1 과 Upgrade · Connection 헤더 전달이 필요합니다.

RFC 9110 15.2.2

102 Processing 표준

WebDAV 중간 응답: 아직 처리 중이라는 뜻입니다.

흔한 원인 오래 걸리는 WebDAV 작업. 지금은 거의 보이지 않습니다.

RFC 2518

103 Early Hints 표준

최종 응답 전에 Link 헤더를 먼저 보내 브라우저가 자원을 미리 받게 하는 중간 응답입니다.

흔한 원인 미리 받기 힌트를 보내는 CDN · 서버.

nginx

early_hints 지시어로 다룹니다.

RFC 8297

104 Upload Resumption Supported (TEMPORARY - registered 2024-11-13, extension registered 2025-09-15, expires 2026-11-13) 표준

재개 가능한 업로드 초안의 임시 등록: 서버가 이 업로드를 이어 받을 수 있다는 뜻입니다.

흔한 원인 재개 가능한 업로드 초안을 구현한 서버.

draft-ietf-httpbis-resumable-upload-05

200 OK 표준

요청이 성공했습니다.

HAProxy

통계 페이지와 모니터링 요청에 대한 응답.

RFC 9110 15.3.1

201 Created 표준

새 자원이 만들어졌습니다. 보통 Location 헤더에 주소가 옵니다.

흔한 원인 무언가를 만드는 API 에 POST · PUT.

RFC 9110 15.3.2

202 Accepted 표준

처리하겠다고 받았지만 아직 끝나지 않았습니다.

흔한 원인 비동기 작업 · 대기열.

RFC 9110 15.3.3

203 Non-Authoritative Information 표준

성공이지만 중간의 변환 프록시가 원 서버의 200 응답 내용을 바꿨습니다.

흔한 원인 응답을 고쳐 쓰는 프록시.

RFC 9110 15.3.4

204 No Content 표준

성공, 본문 없음.

흔한 원인 DELETE · PUT API, CORS 사전 요청(OPTIONS) 응답.

RFC 9110 15.3.5

205 Reset Content 표준

성공. 클라이언트는 화면(예: 폼)을 초기화해야 합니다.

흔한 원인 드묾.

RFC 9110 15.3.6

206 Partial Content 표준

Range 로 요청한 바이트 범위만 보냅니다.

흔한 원인 동영상 재생, 이어 받기(curl -C -).

RFC 9110 15.3.7

207 Multi-Status 표준

WebDAV: 본문에 여러 자원 각각의 상태가 들어 있습니다.

흔한 원인 WebDAV 클라이언트(PROPFIND).

RFC 4918

208 Already Reported 표준

WebDAV: 같은 다중 상태 응답 안에서 이미 나온 항목은 다시 나열하지 않습니다.

흔한 원인 WebDAV 바인딩.

RFC 5842

226 IM Used 표준

응답이 현재 자원에 대한 차분(인스턴스 조작)입니다.

흔한 원인 델타 인코딩. 드묾.

RFC 3229

300 Multiple Choices 표준

여러 표현이 있어 클라이언트가 고를 수 있습니다.

흔한 원인 드묾.

RFC 9110 15.4.1

301 Moved Permanently 표준

Location 의 주소로 영구 이동했습니다. 따라갈 때 POST 를 GET 으로 바꾸는 클라이언트가 있습니다.

흔한 원인 HTTP → HTTPS, www → 루트, 옮긴 페이지.

nginx

return 301 … 또는 rewrite … permanent.

HAProxy

코드 301 의 redirect.

RFC 9110 15.4.2

302 Found 표준

Location 으로 임시 이동. 따라갈 때 POST 를 GET 으로 바꾸는 클라이언트가 있습니다.

흔한 원인 로그인으로 보내기, 임시 이동.

nginx

return 302 … 또는 rewrite … redirect.

HAProxy

코드 302(기본값)의 redirect.

RFC 9110 15.4.3

303 See Other 표준

결과는 Location 에서 GET 으로 받습니다.

흔한 원인 폼 제출 뒤 POST/리다이렉트/GET.

HAProxy

코드 303 의 redirect.

RFC 9110 15.4.4

304 Not Modified 표준

가지고 있는 캐시가 아직 유효합니다. 본문은 없습니다.

흔한 원인 If-None-Match · If-Modified-Since 조건부 요청.

RFC 9110 15.4.5

305 Use Proxy 표준

폐지됨: 프록시를 거쳐 접근하라는 뜻.

흔한 원인 쓰이지 않음.

RFC 9110 15.4.6

306 (Unused) 표준

예약됨. 이전 초안에서 쓰였고 지금은 쓰지 않습니다.

RFC 9110 15.4.7

307 Temporary Redirect 표준

메서드와 본문을 그대로 둔 채 임시 이동합니다.

흔한 원인 브라우저의 HSTS 내부 이동, API 이전.

HAProxy

코드 307 의 redirect.

RFC 9110 15.4.8

308 Permanent Redirect 표준

메서드와 본문을 그대로 둔 채 영구 이동합니다.

흔한 원인 옮긴 API 주소.

HAProxy

코드 308 의 redirect.

RFC 9110 15.4.9

400 Bad Request 표준

요청이 잘못된 꼴이라 처리할 수 없습니다.

흔한 원인 깨진 문법 · JSON, 잘못된 헤더, 너무 큰 헤더 · 쿠키.

nginx

헤더 한 줄이 large_client_header_buffers 버퍼 하나보다 큼(「Request Header Or Cookie Too Large」, 안에서는 494), HTTPS 포트로 평문 HTTP(안에서는 497), 클라이언트 인증서 오류(495 · 496).

HAProxy

잘못되었거나 너무 큰 요청.

RFC 9110 15.5.1

401 Unauthorized 표준

인증이 필요하거나 실패했습니다. 응답에 WWW-Authenticate 가 옵니다.

흔한 원인 자격 증명 없음 · 틀림, 만료된 토큰.

nginx

auth_basic 에 올바른 자격 증명이 없음.

HAProxy

인증 필요(예: 통계 페이지).

RFC 9110 15.5.2

402 Payment Required 표준

나중을 위해 예약됨.

흔한 원인 일부 API 가 결제 · 한도에 씁니다.

RFC 9110 15.5.3

403 Forbidden 표준

요청을 이해했지만 거부합니다.

흔한 원인 접근 규칙, 파일 권한, 방화벽 · WAF 차단.

nginx

deny 규칙, nginx 가 읽을 수 없는 파일, index 파일이 없고 autoindex off 인 디렉터리.

HAProxy

http-request deny 규칙.

Cloudflare

WAF 규칙 · 보안 기능 · DDoS 보호와 대부분의 1xxx 오류(예: 1020 Access denied)가 403 으로 나갑니다.

RFC 9110 15.5.4

404 Not Found 표준

자원이 없습니다(또는 있다고 밝히지 않음).

흔한 원인 틀린 경로, 지운 페이지, 잘못된 root · 라우팅.

HAProxy

요청한 자원을 찾을 수 없음.

RFC 9110 15.5.5

405 Method Not Allowed 표준

이 자원에는 그 메서드를 쓸 수 없습니다. 응답의 Allow 에 허용 메서드가 옵니다.

흔한 원인 정적 파일에 POST, API 경로에 틀린 메서드.

RFC 9110 15.5.6

406 Not Acceptable 표준

Accept* 헤더에 맞는 표현이 없습니다.

흔한 원인 엄격한 내용 협상.

RFC 9110 15.5.7

407 Proxy Authentication Required 표준

프록시가 자격 증명을 요구합니다(Proxy-Authenticate).

흔한 원인 회사 프록시.

RFC 9110 15.5.8

408 Request Timeout 표준

완전한 요청을 기다리다 포기했습니다.

흔한 원인 느리거나 멈춘 클라이언트, 놀고 있는 keep-alive 연결.

nginx

client_header_timeout · client_body_timeout 초과.

HAProxy

요청이 끝나기 전에 요청 시간 제한에 걸림.

Cloudflare

대개 원 서버의 것을 그대로 전달합니다. 클라이언트 요청이 Cloudflare 내부 시간 제한을 넘어도 냅니다.

RFC 9110 15.5.9 · 매뉴얼: HAProxy 로그 한 줄 읽기 — 상태 코드와 종료 상태

409 Conflict 표준

요청이 자원의 현재 상태와 충돌합니다.

흔한 원인 편집 충돌, 중복 키, 버전 불일치.

RFC 9110 15.5.10

410 Gone 표준

자원이 영구히 없어졌습니다.

흔한 원인 일부러 없앤 페이지 · API 버전.

HAProxy

자원이 더는 없고 다시 생기지 않음.

RFC 9110 15.5.11

411 Length Required 표준

서버가 Content-Length 헤더를 요구합니다.

흔한 원인 길이 없이 보낸 본문.

RFC 9110 15.5.12

412 Precondition Failed 표준

If-Match · If-Unmodified-Since 조건이 거짓입니다.

흔한 원인 ETag 를 쓴 낙관적 잠금.

RFC 9110 15.5.13

413 Content Too Large 표준

요청 본문이 서버가 받는 크기보다 큽니다.

흔한 원인 크기 제한을 넘는 업로드 · JSON 본문.

nginx

본문이 client_max_body_size(기본 1m)보다 큼.

HAProxy

HTTP/1.0 GET · HEAD · DELETE 요청에 본문이 있음(h1-accept-payload-with-any-method 참고).

Cloudflare

업로드가 존의 최대 업로드 크기(Free · Pro 100MB, Business 200MB)를 넘음.

RFC 9110 15.5.14

414 URI Too Long 표준

요청 URI 가 서버가 받는 길이보다 깁니다.

흔한 원인 아주 긴 쿼리, 매개변수를 계속 덧붙이는 리다이렉트 고리.

nginx

요청 줄이 large_client_header_buffers 버퍼 하나에 들어가지 않음.

Cloudflare

URI 가 32KB 를 넘음.

RFC 9110 15.5.15

415 Unsupported Media Type 표준

본문 형식(Content-Type · Content-Encoding)을 지원하지 않습니다.

흔한 원인 Content-Type: application/json 없이 JSON 을 보냄, JSON API 에 폼 데이터.

RFC 9110 15.5.16

416 Range Not Satisfiable 표준

요청한 바이트 범위가 자원 밖입니다.

흔한 원인 바뀌었거나 작아진 파일을 이어 받기.

RFC 9110 15.5.17

417 Expectation Failed 표준

서버가 Expect 헤더를 들어줄 수 없습니다.

흔한 원인 Expect: 100-continue 를 거부하는 서버 · 프록시.

RFC 9110 15.5.18

418 (Unused) 표준

예약됨. 만우절 RFC 2324 의 「I’m a teapot」 으로 알려져 있고, RFC 9110 이 다른 용도로 배정되지 않게 예약했습니다.

흔한 원인 장난 · 이스터에그 응답.

RFC 9110 15.5.19

421 Misdirected Request 표준

이 호스트에 대해 답할 수 없는 서버로 요청이 갔습니다.

흔한 원인 다른 호스트에 재사용된 HTTP/2 연결, SNI 와 Host 불일치.

Cloudflare

가장 흔한 것은 SNI 와 Host 불일치. 연결 병합 · Tunnel ingress · 사용자 도메인 불일치도.

RFC 9110 15.5.20

422 Unprocessable Content 표준

문법은 맞지만 내용을 처리할 수 없습니다.

흔한 원인 API 의 입력값 검증 오류.

RFC 9110 15.5.21

423 Locked 표준

WebDAV: 자원이 잠겨 있습니다.

흔한 원인 다른 클라이언트가 잠근 파일.

RFC 4918

424 Failed Dependency 표준

WebDAV: 기대던 다른 동작이 실패해서 이 동작도 실패했습니다.

RFC 4918

425 Too Early 표준

다시 재생될 수 있는 요청(TLS early data)을 처리하지 않겠다는 뜻입니다.

흔한 원인 TLS 1.3 0-RTT 요청.

RFC 8470

426 Upgrade Required 표준

Upgrade 에 적힌 다른 프로토콜로 바꿔야 합니다.

RFC 9110 15.5.22

428 Precondition Required 표준

조건부 요청(If-Match)이어야 합니다.

흔한 원인 덮어쓰기 사고를 막는 API.

RFC 6585

429 Too Many Requests 표준

요청 수 제한을 넘었습니다. Retry-After 에 다시 시도할 때가 올 수 있습니다.

흔한 원인 API 한도, 봇, 재시도 폭주.

nginx

설정했을 때만: limit_req_status 429(기본값은 503).

Cloudflare

Cloudflare API 한도(예: 토큰당 5분에 1200회).

RFC 6585

431 Request Header Fields Too Large 표준

헤더가 너무 큽니다.

흔한 원인 아주 큰 쿠키 · 토큰.

nginx

nginx 는 대신 400(「Request Header Or Cookie Too Large」)을 냅니다.

RFC 6585

444 Close connection without response nginx 전용

nginx 가 아무것도 보내지 않고 연결을 끊습니다(return 444;). nginx 접속 로그에만 보입니다.

흔한 원인 원치 않는 호스트 · 스캐너 막기. 클라이언트는 빈 응답을 받습니다(curl: 「Empty reply from server」).

nginx: ngx_http_rewrite_module · ngx_http_request.h

451 Unavailable For Legal Reasons 표준

법적 이유로 막혔습니다.

흔한 원인 법원 명령, 지역 제한.

RFC 7725

494 Request Header Or Cookie Too Large nginx 전용

요청 헤더가 large_client_header_buffers 버퍼 하나보다 클 때 nginx 안에서 쓰는 코드입니다. 클라이언트에는 400 으로 나가고 error_page 494 로 따로 잡을 수 있습니다.

흔한 원인 큰 쿠키 · 토큰.

nginx: ngx_http_request.h

495 The SSL certificate error nginx 전용

클라이언트 인증서 검증 중 오류가 났습니다. 클라이언트에는 400 으로 나가고 error_page 로 잡을 수 있습니다.

흔한 원인 상호 TLS 에서 잘못되었거나 믿을 수 없는 클라이언트 인증서.

nginx: ngx_http_ssl_module · ngx_http_special_response.c

496 No required SSL certificate was sent nginx 전용

필요한 클라이언트 인증서를 내지 않았습니다. 클라이언트에는 400 으로 나가고 error_page 로 잡을 수 있습니다.

흔한 원인 ssl_verify_client on 인데 클라이언트 인증서 없음.

nginx: ngx_http_ssl_module · ngx_http_special_response.c

497 The plain HTTP request was sent to HTTPS port nginx 전용

HTTPS 포트로 평문 HTTP 요청이 왔습니다. 클라이언트에는 400 으로 나가고 error_page 497 https://$host$request_uri; 로 돌려보낼 수 있습니다.

흔한 원인 http://example.com:443/, 프록시 · 헬스 체크의 포트 착오.

nginx: ngx_http_ssl_module · ngx_http_special_response.c

499 Client closed request nginx 전용

nginx 가 응답 헤더를 보내기 전에 클라이언트가 연결을 끊었습니다. 로그에만 남고 보내는 것은 없습니다.

흔한 원인 느린 백엔드보다 짧은 클라이언트 · 앞단 프록시의 시간 제한, 페이지를 떠난 사용자. Cloudflare 로그에도 남습니다.

nginx: ngx_http_request.h

500 Internal Server Error 표준

일반적인 서버 쪽 실패입니다.

흔한 원인 앱 예외, 설정 오류.

nginx

rewrite · 내부 리다이렉트 고리 같은 설정 문제.

HAProxy

회복할 수 없는 내부 오류(일어나면 안 됨).

Cloudflare

Cloudflare 오류 페이지가 따로 있습니다.

RFC 9110 15.6.1 · 매뉴얼: Nginx 접속 로그에서 5xx 를 내는 경로 찾기

501 Not Implemented 표준

필요한 기능(예: 메서드)을 지원하지 않습니다.

흔한 원인 모르는 메서드 · 전송 인코딩.

HAProxy

클라이언트 요청이 지원하지 않는 기능을 씀.

Cloudflare

Cloudflare 오류 페이지가 따로 있습니다.

RFC 9110 15.6.2

502 Bad Gateway 표준

프록시 · 게이트웨이가 위쪽 서버로부터 잘못된 응답을 받았거나 받지 못했습니다.

흔한 원인 백엔드 꺼짐, 연결 거부, 앱 죽음, 너무 큰 위쪽 헤더.

nginx

error.log 에 이유가 남습니다: connect() failed (111: Connection refused) · upstream prematurely closed connection · upstream sent too big header · no live upstreams.

HAProxy

서버가 빈 · 잘못된 · 불완전한 응답을 줬거나 http-response deny 규칙에 걸림.

Cloudflare

Cloudflare 의 502/504 오류 페이지가 있습니다. 꾸밈 없는 페이지는 대개 원 서버의 것.

RFC 9110 15.6.3 · 매뉴얼: Nginx 502 Bad Gateway — 오류 로그 문구로 원인 가르기

503 Service Unavailable 표준

지금은 요청을 처리할 수 없습니다. Retry-After 에 시점이 올 수 있습니다.

흔한 원인 과부하, 점검, 건강한 백엔드 없음, 요청 수 제한.

nginx

limit_req · limit_conn 이 기본으로 503 을 냅니다(limit_req_status).

HAProxy

쓸 수 있는 서버가 없음, 또는 모니터링 요청이 monitor fail 조건에 맞음.

Cloudflare

Cloudflare 오류 페이지가 따로 있습니다.

RFC 9110 15.6.4 · 매뉴얼: HAProxy 로그 한 줄 읽기 — 상태 코드와 종료 상태

504 Gateway Timeout 표준

프록시 · 게이트웨이가 위쪽 서버의 응답을 제때 받지 못했습니다.

흔한 원인 느린 백엔드 쿼리, 긴 작업, 네트워크 문제.

nginx

error.log 의 upstream timed out — 백엔드가 proxy_read_timeout(기본 60초)이나 연결 제한 시간 안에 답하지 않음.

HAProxy

서버가 응답하기 전에 응답 시간 제한에 걸림.

Cloudflare

Cloudflare 의 502/504 오류 페이지가 있습니다(연결 뒤 원 서버가 느리면 524).

RFC 9110 15.6.5 · 매뉴얼: HAProxy 로그 한 줄 읽기 — 상태 코드와 종료 상태

505 HTTP Version Not Supported 표준

요청의 HTTP 버전을 지원하지 않습니다.

흔한 원인 연결에 엉뚱한 바이트, HTTP 가 아닌 클라이언트.

RFC 9110 15.6.6

506 Variant Also Negotiates 표준

내용 협상 설정 오류: 고른 변형이 다시 협상합니다.

흔한 원인 드묾.

RFC 2295

507 Insufficient Storage 표준

WebDAV: 요청을 마칠 저장 공간이 모자랍니다.

흔한 원인 WebDAV 서버의 디스크 · 할당량 가득.

RFC 4918

508 Loop Detected 표준

WebDAV: 처리 중 무한 고리를 찾았습니다.

RFC 5842

510 Not Extended (OBSOLETED) 표준

폐지됨: 확장이 더 필요하다는 뜻이었습니다.

흔한 원인 쓰이지 않음.

RFC 2774 · Status change of HTTP experiments to Historic

511 Network Authentication Required 표준

먼저 네트워크에 로그인해야 합니다.

흔한 원인 공용 Wi-Fi 의 로그인 페이지.

RFC 6585

520 Web server returns an unknown error Cloudflare 전용

원 서버가 Cloudflare 에 빈 · 알 수 없는 · 예상 밖의 응답을 줬습니다.

흔한 원인 원 서버 죽음, Cloudflare IP 를 막은 방화벽, 128KB 넘는 헤더, 상태 줄 없는 응답, HTTP/2 설정 오류.

Cloudflare docs: Error 520

521 Web server is down Cloudflare 전용

원 서버가 Cloudflare 의 연결을 거부했습니다.

흔한 원인 웹 서버가 꺼짐, Cloudflare IP 차단, 80(Flexible) · 443(Full) 에 듣는 프로세스 없음.

Cloudflare docs: Error 521

522 Connection timed out Cloudflare 전용

Cloudflare 가 원 서버에 닿지 못하고 시간 초과: 19초 안에 SYN+ACK 이 없거나, 연결 뒤 90초 안에 요청에 대한 ACK 이 없음.

흔한 원인 Cloudflare IP 를 제한 · 버리는 방화벽, 과부하, DNS 의 틀린 원 서버 IP.

Cloudflare docs: Error 522

523 Origin is unreachable Cloudflare 전용

Cloudflare 가 원 서버에 닿을 수 없습니다 — 그 IP 로 가는 경로가 없습니다.

흔한 원인 틀린 A/AAAA 레코드, 라우팅 문제(AWS 에서 172.64.0.0/13 을 삼키는 넓은 경로).

Cloudflare docs: Error 523

524 A timeout occurred Cloudflare 전용

연결은 됐지만 원 서버가 Proxy Read Timeout(기본 125초) 안에 HTTP 응답을 주지 않았습니다.

흔한 원인 오래 걸리는 요청, 과부하.

Cloudflare docs: Error 524

525 SSL handshake failed Cloudflare 전용

Cloudflare 와 원 서버 사이 TLS 핸드셰이크가 실패했습니다(SSL 모드 Full · Full (strict)).

흔한 원인 올바른 인증서 없음, 443 닫힘, SNI 미지원, 맞는 암호 묶음 없음.

Cloudflare docs: Error 525

526 Invalid SSL certificate Cloudflare 전용

Cloudflare 가 원 서버 인증서를 검증하지 못합니다(SSL 모드 Full (strict)).

흔한 원인 만료 · 자체 서명 · 이름이 다른 인증서, 빠진 중간 인증서.

Cloudflare docs: Error 526

530 Error 530 Cloudflare 전용

Cloudflare 가 원 서버 호스트 이름을 풀지 못합니다. 본문에 1xxx 오류 코드가 있습니다.

흔한 원인 페이지의 1xxx 오류를 봅니다(예: 1016 Origin DNS error).

Cloudflare docs: Error 530