HTTP 응답 코드 및 원인 정리

🌐 HTTP 응답 코드 및 원인 정리

웹사이트를 운영하거나 웹 개발을 하다 보면 다양한 에러 코드(HTTP 상태 코드)를 마주치게 됩니다. 이 글에서는 자주 발생하는 에러 코드의 의미와 원인을 체계적으로 정리하여 소개합니다.

1. HTTP 상태 코드란?

HTTP 상태 코드는 클라이언트(브라우저 등)와 서버가 통신할 때, 서버가 클라이언트의 요청에 대해 어떤 결과를 반환했는지를 알려주는 숫자 코드입니다.

분류	의미
1xx	정보 응답
2xx	성공
3xx	리디렉션
4xx	클라이언트 오류
5xx	서버 오류

2. ✅ 1xx: 정보 응답

코드	의미	설명
100	Continue	요청을 계속하라는 응답
101	Switching Protocols	프로토콜 전환 수락

3. ✅ 2xx: 성공 응답

코드	의미	설명
200	OK	요청이 정상적으로 처리됨
201	Created	요청 성공 + 리소스 생성됨
204	No Content	성공했지만 응답 본문 없음

4. ⚠️ 3xx: 리디렉션

코드	의미	설명
301	Moved Permanently	리소스가 영구적으로 이동됨
302	Found	임시로 다른 위치에 있음
304	Not Modified	캐시된 리소스를 그대로 사용하라는 응답

5. ❗ 4xx: 클라이언트 오류

코드	의미	원인 예시
400	Bad Request	잘못된 요청 (파라미터 오류 등)
401	Unauthorized	인증 필요 (로그인/토큰 필요)
403	Forbidden	권한 없음 (접근 제한)
404	Not Found	존재하지 않는 URL 요청
405	Method Not Allowed	허용되지 않은 HTTP 메서드
408	Request Timeout	요청 시간이 초과됨
409	Conflict	요청이 서버와 충돌 (중복 등)
429	Too Many Requests	요청 과다 (rate limit 초과)

6. 🔥 5xx: 서버 오류

코드	의미	원인 예시
500	Internal Server Error	서버 내부 에러 (예외, DB 오류 등)
501	Not Implemented	기능 미구현
502	Bad Gateway	게이트웨이에서 잘못된 응답 수신
503	Service Unavailable	서버 과부하 또는 유지보수
504	Gateway Timeout	백엔드 서버 응답 없음 (타임아웃)

7. 🔐 TIP

• 401 Unauthorized: 인증이 필요하거나 로그인 세션이 만료된 경우 발생
• 403 Forbidden: 로그인했지만 해당 리소스에 접근할 권한이 없음
• 404 Not Found: 존재하지 않는 리소스를 숨기기 위해 일부러 반환하는 경우도 있음

8. ✅ 마무리

HTTP 상태 코드는 사용자 경험과 웹 디버깅에 매우 중요한 요소입니다. 웹 개발자뿐 아니라 운영자, 디자이너 모두가 알아두면 좋습니다.

이 외에도 웹 서버 설정, 캐시 처리, 프록시 환경 설정 등에 따라 추가적인 오류가 발생할 수 있으므로 실무에서 다양한 로그 확인과 디버깅 경험을 쌓는 것이 중요합니다.