HTTP 상태코드 정리

이건우·2025년 3월 21일

웹 프로그래밍

목록 보기
28/43

1xx: 정보 응답 (Informational)

요청을 받았으며, 처리를 계속하고 있다는 의미

100 Continue

클라이언트가 모든 요청 헤더를 전송했으며, 이제 본문을 보내도 된다는 의미


2xx: 성공 (Success)

요청이 정상적으로 처리됨

200 OK

요청이 성공적으로 처리되었을 때 사용 (가장 일반적인 응답)

201 Created

리소스가 성공적으로 생성됨 (POST 요청 등)

204 No Content

요청은 성공했지만 반환할 컨텐츠가 없을 때 사용 (ex: 삭제 성공)


3xx: 리다이렉션 (Redirection)

클라이언트는 요청을 완료하기 위해 추가 동작이 필요함

301 Moved Permanently

요청한 리소스가 영구적으로 다른 URL로 이동함

302 Found (혹은 Moved Temporarily)

임시로 다른 URL로 이동함 (브라우저 리다이렉트 시 자주 사용)

304 Not Modified

캐시된 리소스를 사용해도 된다는 의미 (브라우저 캐시)


4xx: 클라이언트 오류 (Client Error)

클라이언트의 잘못된 요청

400 Bad Request

요청 문법이 잘못되었거나 누락된 데이터가 있는 경우

401 Unauthorized

인증이 필요하거나, 인증 정보가 잘못된 경우
(로그인이 필요한 API 요청 등)

403 Forbidden

권한이 없는 사용자 접근 시 (인증은 되었으나 인가되지 않음)

404 Not Found

요청한 리소스를 찾을 수 없음 (URL 오타, 삭제된 리소스 등)

405 Method Not Allowed

지원하지 않는 HTTP 메서드로 요청했을 경우


5xx: 서버 오류 (Server Error)

서버가 요청을 정상 처리하지 못함

500 Internal Server Error

서버 내부 에러 (가장 일반적인 서버 오류)

502 Bad Gateway

게이트웨이/프록시 서버가 잘못된 응답을 받은 경우

503 Service Unavailable

서버가 과부하 혹은 점검 중으로 일시적으로 불가능한 상태

504 Gateway Timeout

게이트웨이/프록시 서버가 응답을 제때 받지 못했을 경우


주요 정리

코드의미자주 사용하는 경우
200성공대부분의 GET, POST 요청
201생성됨회원가입, 글쓰기 등 POST
400잘못된 요청유효성 검사 실패 등
401인증 실패로그인 필요
403권한 없음관리자 전용 요청 등
404없음잘못된 URL
500서버 오류예외 처리 누락 등
profile
새싹개발자

0개의 댓글