HTTP - 4xx 클라이언트 오류, 5xx 서버 오류

4xx (Client Error)

클라이언트 오류

• 클라이언트의 요청에 잘못된 문법등으로 서버가 요청을 수행할 수 없다.
• 오류의 원인이 클라이언트에 있다.
• 중요!!!
  • 클라이언트가 이미 잘못된 요청, 데이터를 보내고 있기 때문에 똑같은 재시도를 하면 무조건 실패한다.

400 Bad Request

클라이언트가 잘못된 요청을 해서 서버가 요청을 처리할 수 없다.

• 요청 구문, 메시지 등등 오류
• 클라이언트는 요청 내용을 다시 검토하고 보내야함.
• 예 : 요청 파라미터가 잘못되거나, API 스펙이 맞지 않을 때
  • 백엔드 개발자는 철저하게 막아야 한다.
    • 5xx 오류를 발생시키면 서버에서 잘못된줄 알기 때문.

401 Unauthorized

클라이언트가 해당 리소스에 대한 인증이 필요하다.

• 인증(Authentication) 되지 않음
• 401 오류 발생시 응답에 WWW-Authenticate 헤더와 함께 인증 방법을 설명해야함.
• 참고
  • 인증(Authentication): 본인이 누구인지 확인 (로그인)
  • 인가(Authorization): 권한부여 (ADMIN 권한처럼 특정 리소스에 접근할 수 있는 권한, 인증이 있어야 인가가 있음)
  • 오류 메시지가 Unauthorized 이지만 인증에 대한 오류 메시지다.

403 Forbidden

서버가 요청을 이해했지만 승인을 거부한다.

• 주로 인증 자격 증명은 있지만, 접근 권한이 불충분한 경우
  • 예 : 어드민 등급이 아닌 사용자가 로그인은 했지만, 어드민 등급의 리소스에 접근하는 경우

404 Not Found

요청 리소스를 찾을 수 없음

• 요청 리소스가 서버에 없다.
• 또는 클라이언트가 권한이 부족한 리소스에 접근할 때 해당 리소스를 숨기고 싶을 때 사용할 수 있다.
  • 403 대신 사용할 수 있음.

5xx (Server Error)

서버 오류

• 서버 문제로 오류 발생
• 서버에 문제가 있기 때문에 같은 재시도를 하면 성공할 수도 있다.(서버 복구 등)

500 Internal Server Error

• 서버 내부 문제로 오류 발생
• 애매하면 500 오류

503 Service Unavailable

서비스 이용 불가

• 서버가 일시적인 과부하 또는 예정된 작업(약 n시간동안 서버 점검 등)으로 잠시 요청을 처리할 수 없다.
• Retry-After 헤더 필드로 얼마뒤에 복구되는지 보낼 수도 있음.

참고

• 4xx 오류는 클라이언트에서 스펙을 잘 못 맞췄거나, 인증이 되지 않아서 발생하는 경우가 많다.
• 비즈니스 로직에서 예외 케이스는 5xx를 내면 안되고, 서버 문제(로직 문제, NPE, DB 문제 등)가 아닌 이상 5xx 오류는 만들지 않아야 한다.
  • 예외 케이스 예시 : 고객이 계좌이체할 때 잔액이 부족한 경우

인프런 김영한 지식 공유자님의 강의 - 모든 개발자를 위한 HTTP 웹 기본 지식