작성일 2026년 11월 16일 · 기준: IETF RFC 9110(HTTP Semantics), MDN Web Docs
핵심 답: HTTP 상태 코드는 서버가 요청 결과를 알려 주는 세 자리 숫자이고, 첫 자리로 성격이 갈려요(2xx 성공, 3xx 이동, 4xx 요청 쪽 문제, 5xx 서버 쪽 문제). 헷갈리는 401은 "누구인지 모름(로그인 필요)", 403은 "누구인지는 알지만 권한 없음"이에요.

안녕하세요, 잇커니즘이에요. 개발자라면 매일 보는 숫자지만, 기획자·디자이너·마케터 입장에서는 "API가 403 떠요", "그 페이지 404예요" 같은 말이 오가면 무슨 상황인지 바로 감이 안 올 때가 많아요. 이 글에서는 HTTP 상태 코드를 표준 문서(RFC 9110)와 MDN 기준으로 정리하고, 현업에서 자주 헷갈리는 코드와 흔한 실수, 바로 써먹는 체크리스트까지 담았어요.
HTTP 상태 코드란 무엇인가요?
브라우저나 앱이 서버에 요청(request)을 보내면, 서버는 응답(response)에 세 자리 숫자를 붙여 "어떻게 처리됐는지"를 알려줘요. 이게 HTTP 상태 코드예요. RFC 9110은 유효한 상태 코드를 100~599 범위로 정하고, 첫 자리만 분류 의미가 있으며 뒤 두 자리는 분류 역할이 없다고 설명해요. 그래서 처음 보는 코드라도 첫 자리만 보면 대략 누구 쪽 문제인지 짐작할 수 있어요.

| 분류 | 의미 | 자주 보는 코드 | 먼저 볼 곳 |
| 1xx 정보 | 요청을 받았고 처리 중 | 101(프로토콜 전환), 103 | 거의 신경 쓸 일 없음 |
| 2xx 성공 | 요청이 정상 처리됨 | 200 OK, 201 Created, 204 No Content | - |
| 3xx 리다이렉션 | 다른 주소로 가야 함 | 301, 302, 304, 307, 308 | 주소 이전·캐시 설정 |
| 4xx 클라이언트 오류 | 요청 자체에 문제가 있음 | 400, 401, 403, 404, 409, 429 | 보낸 값·로그인·권한 |
| 5xx 서버 오류 | 정상 요청인데 서버가 처리 못 함 | 500, 502, 503, 504 | 서버 로그·배포·인프라 |
401과 403은 어떻게 다른가요?

가장 많이 헷갈리는 쌍이에요. RFC 9110 기준으로 정리하면 이렇습니다.
- 401 Unauthorized: 대상 리소스에 대한 유효한 인증 정보가 없어서 요청이 처리되지 않았다는 뜻이에요. 이름은 "Unauthorized"지만 MDN도 의미상 "비인증(unauthenticated)"에 가깝다고 설명해요. 표준상 401을 보낼 때는
WWW-Authenticate헤더를 함께 보내야 해요. - 403 Forbidden: 서버가 요청을 이해했지만 거부한다는 뜻이에요. 인증 정보를 보냈다면 "그 정보로는 접근 권한이 부족하다"는 의미이고, 같은 인증 정보로 자동 재시도하면 안 돼요.
예를 들어 로그인 API를 만든다면, 토큰 없이 /api/me를 부르면 401, 일반 회원 토큰으로 관리자용 /api/admin/users를 부르면 403이 자연스러워요. 화면 기획에서도 401이면 "로그인 화면으로 이동", 403이면 "권한이 없어요 안내"처럼 처리가 달라져요.
참고로 RFC 9110은 리소스가 있다는 사실 자체를 숨기고 싶을 때 403 대신 404로 응답해도 된다고 허용해요. 다른 사람의 주문 번호를 넣었을 때 404가 나오는 서비스가 있는 이유예요.
현업에서 자주 보는 상태 코드는 무엇인가요?
- 200 / 201 / 204: 조회 성공은 200, POST로 새로 만들었으면 201, 삭제처럼 돌려줄 내용이 없으면 204를 많이 써요.
- 301 / 308 vs 302 / 307: 앞의 둘은 영구 이동, 뒤의 둘은 임시 이동이에요. 307·308은 처음 요청의 메서드(POST 등)를 바꾸지 말아야 한다는 점이 302·301과 달라요. 주소를 영구히 바꿨다면 영구 리다이렉트를 쓰는 게 기본이에요.
- 304 Not Modified: 오류가 아니에요. 캐시된 버전을 그대로 써도 된다는 뜻이라 개발자도구에서 304가 보이면 정상인 경우가 많아요.
- 400 / 409: 400은 형식이 잘못된 요청, 409는 현재 서버 상태와 충돌(예: 이미 있는 아이디로 가입)할 때 써요.
- 429 Too Many Requests: 정해진 시간 안에 요청을 너무 많이 보냈다는 뜻이에요(속도 제한). 응답에
Retry-After헤더가 있으면 그 시간만큼 기다렸다가 다시 보내요. - 500 / 502 / 503 / 504: 서버 쪽 문제예요. 500은 서버 내부 오류, 502·504는 앞단(게이트웨이·프록시)이 뒤 서버에서 제대로 된 응답을 못 받았을 때, 503은 점검·과부하로 잠시 처리할 수 없을 때 주로 봐요.
코드에서는 상태 코드를 어떻게 처리하나요?
프런트엔드에서 fetch를 쓸 때 흔한 실수가 "에러면 catch로 빠지겠지"라고 생각하는 거예요. fetch는 404나 500을 받아도 예외를 던지지 않고 정상적으로 응답을 돌려줘요. 그래서 res.ok(200~299면 true)나 res.status를 직접 확인해야 해요.
const res = await fetch('/api/me');
if (res.status === 401) {
// 로그인 필요: 로그인 화면으로 보내기
} else if (res.status === 403) {
// 권한 없음: 안내 메시지 보여 주기
} else if (!res.ok) {
// 그 밖의 오류: 공통 오류 처리
} else {
const user = await res.json();
}
서버(예: Node.js의 Express)에서는 응답을 보낼 때 상태 코드를 명시해요. 실패인데 200과 함께 {"success": false}를 보내는 방식은 모니터링·캐시·클라이언트 처리가 모두 꼬이기 쉬워서, 의미에 맞는 코드를 쓰는 게 좋아요.
// 예시: 리소스가 없을 때
res.status(404).json({ message: '주문을 찾을 수 없어요' });
상태 코드 관련 흔한 실수와 체크리스트
- 실패 응답을 200으로 보내고 본문에만 실패를 적지 않았나요?
- 로그인 안 됨(401)과 권한 없음(403)을 구분했나요?
- 클라이언트에서
res.ok나status를 확인하나요? - 사용자의 잘못(4xx)과 서버 장애(5xx)를 구분해 알림·모니터링을 걸었나요?
- 429를 받으면 바로 재시도하지 말고
Retry-After를 따르나요? - 주소를 영구히 옮겼다면 임시(302)가 아닌 영구(301·308) 리다이렉트를 썼나요?
자주 묻는 질문
Q. 403 오류가 뜨면 사용자는 무엇을 해야 하나요?
로그인한 계정에 그 페이지를 볼 권한이 없다는 뜻이 많아요. 다른 계정으로 로그인했는지 확인하고, 회사 시스템이라면 관리자에게 권한을 요청하는 게 빠릅니다.
Q. 404와 410은 뭐가 다른가요?
404는 "찾을 수 없음", 410은 "영구적으로 삭제되어 앞으로도 없음"이에요. 일부러 없앤 페이지를 확실히 알리고 싶을 때 410을 쓰기도 해요.
Q. 418 I'm a teapot은 진짜 있는 코드인가요?
만우절 농담에서 나온 코드로 MDN에도 실려 있지만, 실제 서비스 API에서 쓰는 코드는 아니에요. "HTTP 상태 코드 밈"으로 자주 보이는 이유예요.
Q. 개발자가 아닌데 상태 코드를 어디서 확인하나요?
크롬에서 F12(개발자도구) → Network 탭을 열고 새로고침하면 요청마다 Status 열에 상태 코드가 보여요. 버그를 제보할 때 이 숫자와 주소를 함께 적어 주면 개발자가 원인을 훨씬 빨리 찾을 수 있어요.
정리
상태 코드는 첫 자리로 누구 쪽 문제인지를 먼저 보고, 401(로그인 필요)·403(권한 없음)·404(없음)·5xx(서버 문제)만 구분해도 대화가 훨씬 빨라져요. 개발자는 의미에 맞는 코드를 보내고, 함께 일하는 분들은 버그 제보에 상태 코드를 붙여 주는 것만으로도 협업 시간이 줄어듭니다.
출처
'IT정보' 카테고리의 다른 글
| 안드로이드 오토 연결 안됨 해결 방법, USB·무선 체크리스트 총정리 (0) | 2026.11.15 |
|---|---|
| 윈도우11 캡처 단축키 총정리, 부분 캡처부터 저장 위치까지 (0) | 2026.11.14 |
| 디자인 기본 개념 원칙 지식 정렬 근접 반복 대비로 보는 핵심 레이아웃 팁 (0) | 2025.07.28 |
| 컬러 조합 배색 추천 코드 BEST12(썸네일, 배너 디자인용) (0) | 2025.07.16 |
| 카카오톡프로필방문자 확인 가능한가요 멀티프로필 활용법 (0) | 2025.07.04 |