TechFeed
📋
전체
▼
🔍
🎨
테마
TechFeed
›
HTTP 상태 코드
HTTP 상태 코드 사전
코드를 검색하면 의미 → 발생 원인 → 실무 대응을 바로 찾을 수 있습니다. 현재 14개 수록.
리다이렉트 (3xx)
(2)
301
301 Moved Permanently — 영구 이동
요청한 리소스가 새 URL로 영구히 옮겨졌고, 앞으로는 새 URL을 쓰라는 응답입니다. 검색엔진은 이 신호를 받아 색인을 새 URL로 이전합니다.
304
304 Not Modified — 변경 없음(캐시 사용)
클라이언트가 가진 캐시가 최신이라 서버가 본문을 다시 보내지 않고 "그대로 쓰라"고 알리는 응답입니다. 대역폭을 아끼는 정상 동작입니다.
클라이언트 오류 (4xx)
(8)
400
400 Bad Request — 잘못된 요청
서버가 요청 자체를 이해할 수 없을 때(문법 오류·잘못된 형식)의 응답입니다. 클라이언트가 보낸 데이터에 문제가 있다는 뜻입니다.
401
401 Unauthorized — 인증 필요
인증이 안 됐거나 자격 증명이 유효하지 않다는 응답입니다. 이름은 Unauthorized지만 실제 의미는 "인증(authentication) 안 됨"입니다.
403
403 Forbidden — 권한 없음
서버가 요청을 이해하고 인증도 됐지만, 해당 리소스에 접근할 권한이 없다고 거부하는 응답입니다.
404
404 Not Found — 리소스 없음
요청한 URL에 해당하는 리소스를 찾을 수 없다는 응답입니다. 경로 오타부터 삭제된 페이지, 라우팅 누락까지 원인이 다양합니다.
405
405 Method Not Allowed — 허용되지 않은 메서드
리소스는 존재하지만 사용한 HTTP 메서드(GET/POST 등)를 그 엔드포인트가 허용하지 않는다는 응답입니다.
409
409 Conflict — 충돌
요청이 리소스의 현재 상태와 충돌해 처리할 수 없다는 응답입니다. 동시성·중복 생성에서 주로 발생합니다.
422
422 Unprocessable Entity — 검증 실패
요청 문법은 맞지만(400과 달리) 내용이 의미적으로 유효하지 않아 처리할 수 없다는 응답입니다. 폼·API 검증 실패에 흔히 씁니다.
429
429 Too Many Requests — 요청 과다(레이트 리밋)
짧은 시간에 너무 많은 요청을 보내 서버가 제한(rate limit)을 건 응답입니다. API 호출 폭주·재시도 루프에서 발생합니다.
서버 오류 (5xx)
(4)
500
500 Internal Server Error — 서버 내부 오류
서버에서 예기치 못한 오류가 발생해 요청을 처리하지 못했다는 포괄적 응답입니다. 원인은 서버 로그에 있습니다.
502
502 Bad Gateway — 게이트웨이 오류
게이트웨이/프록시가 상위(업스트림) 서버로부터 잘못된 응답을 받았다는 응답입니다. 앞단은 멀쩡한데 뒷단이 문제일 때 납니다.
503
503 Service Unavailable — 서비스 일시 불가
서버가 일시적으로 요청을 처리할 수 없다는 응답입니다. 과부하·점검·콜드스타트 등 일시적 상태를 뜻합니다.
504
504 Gateway Timeout — 게이트웨이 타임아웃
게이트웨이/프록시가 업스트림 서버의 응답을 제한 시간 안에 받지 못했다는 응답입니다. 뒷단이 너무 느릴 때 납니다.
