HTTP 상태 코드와 의미
웹 개발·API 설계·디버깅에서 자주 마주치는 HTTP 상태 코드를 실전 관점에서 정리했습니다. 각 코드의 공식 의미뿐 아니라 어떤 상황에서 반환해야 하고 어떤 클라이언트 동작을 유도하는지, 비슷한 코드와의 차이는 무엇인지까지 함께 설명합니다.
수록 문항
총 18개아래 문항들은 이 학습지에 수록된 카드입니다. 각 카드는 문제(Q)와 답(A)으로 구성되어 있으며, 일부 카드에는 추가 해설이 포함되어 있습니다. 로그인하면 이 학습지를 내 계정으로 복사해 카드를 한 장씩 넘기며 반복 학습할 수 있고, 숙달한 카드는 완료 표시하여 다음 세션에서 제외할 수 있습니다.
-
#1Q.
200
A.OK (정상 처리)
GET·PUT·DELETE 성공에 가장 보편적으로 쓰인다. 응답 본문은 있을 수도 없을 수도 있다. -
#2Q.
201
A.Created (리소스 생성됨)
POST 요청으로 새 리소스가 만들어졌을 때. Location 헤더에 새 리소스 URL을 포함하는 것이 관례. -
#3Q.
204
A.No Content (본문 없음)
성공했지만 돌려줄 본문이 없는 경우. DELETE 성공 응답으로 자주 쓰인다. -
#4Q.
301
A.Moved Permanently (영구 이동)
URL이 영구적으로 변경됨. 검색엔진이 링크를 갱신한다. 영구 리다이렉트는 브라우저도 캐싱한다. -
#5Q.
302
A.Found (임시 이동)
일시적 리다이렉트. 원 URL을 유지하며 다음 요청은 다시 원 URL로 보내야 한다. -
#6Q.
304
A.Not Modified (변경 없음)
조건부 요청(If-None-Match 등)에서 캐시가 유효할 때. 본문을 보내지 않아 트래픽 절약. -
#7Q.
400
A.Bad Request (잘못된 요청)
요청 자체의 문법·형식이 잘못된 경우. 유효성 검증 실패에도 자주 쓰인다. -
#8Q.
401
A.Unauthorized (인증 필요)
이름과 달리 "인증 안 됨"을 의미. 토큰·쿠키가 없거나 만료된 경우. -
#9Q.
403
A.Forbidden (권한 없음)
누군지는 확인됐지만 해당 리소스에 대한 권한이 없는 경우. 401과 핵심 차이. -
#10Q.
404
A.Not Found (리소스 없음)
존재하지 않는 URL. 보안을 위해 403 대신 404를 반환하는 전략도 있다. -
#11Q.
405
A.Method Not Allowed (허용되지 않은 메서드)
URL은 유효하지만 사용한 HTTP 메서드가 지원되지 않음. Allow 헤더로 허용 메서드 명시. -
#12Q.
409
A.Conflict (충돌)
리소스의 현재 상태와 충돌하는 요청. 동시 수정·중복 생성에 자주 쓰인다. -
#13Q.
422
A.Unprocessable Entity (처리 불가)
요청 문법은 맞지만 의미가 유효하지 않은 경우. REST API의 유효성 오류에 자주 쓰인다. -
#14Q.
429
A.Too Many Requests (요청 과다)
Rate Limit 초과. Retry-After 헤더로 재시도 시점을 안내하는 것이 관례. -
#15Q.
500
A.Internal Server Error (서버 내부 오류)
서버 측 예외가 클라이언트에 전달되지 말아야 할 상황. 스택 트레이스 노출에 주의. -
#16Q.
502
A.Bad Gateway (게이트웨이 오류)
리버스 프록시·로드밸런서가 상위 서버로부터 잘못된 응답을 받음. -
#17Q.
503
A.Service Unavailable (서비스 이용 불가)
일시적 과부하·점검. Retry-After로 재시도 시점을 알리는 것이 좋다. -
#18Q.
504
A.Gateway Timeout (게이트웨이 시간 초과)
게이트웨이가 상위 서버의 응답을 시간 내에 받지 못함. 상위 서비스 지연이 원인.
이 학습지를 효과적으로 활용하는 방법
- ① 처음에는 전체 문항을 한 번씩 훑어보며 익숙한 항목과 낯선 항목을 분류하세요.
- ② 학습 세션에서 "안 외운 문항만" 옵션으로 아직 숙달하지 못한 카드에 집중합니다.
- ③ 랜덤 순서 학습을 활용해 카드 순서에 의존한 암기를 방지하세요.
- ④ 키보드 단축키(1·2·A·D·Space)를 쓰면 한 손으로도 빠르게 복습할 수 있습니다.
- ⑤ 복사(Fork)한 학습지에는 자유롭게 나만의 해설이나 예문을 덧붙여 내 스타일로 다듬어 보세요.