🧠 HTTP 상태코드 완전 정리하기 (재밌게, 쉽게, 한 방에!)

📡 “404야, 내 마음도 Not Found다...”

---

✅ HTTP 상태코드란?

서버가 클라이언트의 요청에 대해 어떤 결과를 돌려줬는지 알려주는 숫자 코드입니다.

예를 들어...

• "응, 잘 받았어!" → 200 OK
• "어..? 너 누구?" → 401 Unauthorized
• "뭐라는 거야?" → 400 Bad Request

---

🎯 상태코드는 크게 5가지로 나뉩니다

범위의미예시

1xx	정보	거의 안 씀
2xx	성공	200, 201, 204
3xx	리다이렉트	301, 302, 304
4xx	클라이언트 에러	400, 401, 403, 404
5xx	서버 에러	500, 502, 503, 504

 

---

🔵 2xx: 성공했어요!

코드의미설명

200 OK	정상 처리 완료	제일 자주 보는 성공 코드
201 Created	생성됨	POST로 새 리소스 생성 시
204 No Content	응답 본문 없음	처리는 됐지만 줄 말은 없음

 

---

🟡 3xx: 어이쿠! 이리로 와요~

코드의미설명

301 Moved Permanently	영구 이동	브라우저 캐싱까지 함
302 Found	임시 이동	예전에는 흔히 사용했음
304 Not Modified	변경 없음	캐시 덕에 통신량 절약~

 

---

🔴 4xx: 너가 잘못했어 (Client Error)

코드의미설명

400 Bad Request	요청이 이상해요	문법 오류, 파라미터 실수 등
401 Unauthorized	인증 필요해요	토큰 없어! 로그인 먼저!
403 Forbidden	권한 없어	있어도 안돼요 ❌
404 Not Found	찾을 수 없어요	페이지 없어… 내 인생도...

 

---

⚫ 5xx: 서버가 잘못했어요 (Server Error)

코드의미설명

500 Internal Server Error	서버가 터졌어요 💥	대표적인 오류 코드
502 Bad Gateway	게이트웨이 문제	보통 nginx랑 친함
503 Service Unavailable	잠시만요~	서버 과부하, 점검 중
504 Gateway Timeout	응답 없어요	서버가 너무 느림... zzz

 

---

😂 코드별 상황극 예시

[404 Not Found]
👉 너 걔 봤어?
👤 누구?
👉 내 미래.

[403 Forbidden]
👉 사장님, 이 폴더 좀 볼게요.
👤 ...너 권한 없어. 꺼져.

🔐 상태코드, 실무에선 이렇게 써요!

• API 응답에 반드시 상태코드 명확히 반환
• 정상 처리: 200 또는 201
• 예외 처리: 400, 401, 403, 500 등 구분
• 프론트와 협업 시 명확한 상태 정의 문서 공유 필요