WEB 웹에서 API 오류 정리

 

 

🔹 1. 클라이언트 오류 (4xx)

클라이언트의 요청이 잘못되었거나 인증/권한이 부족할 때 발생.

400 Bad Request	잘못된 요청	- 요청 파라미터가 잘못되었거나 필수 값 누락 - JSON 형식 오류 - 요청 헤더 문제
401 Unauthorized	인증 실패	- API 키 또는 토큰이 없거나 유효하지 않음 - 세션이 만료됨
403 Forbidden	권한 없음	- 인증은 성공했지만, 해당 API에 대한 접근 권한 없음
404 Not Found	리소스를 찾을 수 없음	- 잘못된 URL 요청 - 해당 ID의 데이터 없음
405 Method Not Allowed	잘못된 HTTP 메서드 사용	- GET, POST, PUT, DELETE 중 잘못된 메서드 사용
408 Request Timeout	요청 시간 초과	- 네트워크 지연 또는 서버가 응답하지 않음
429 Too Many Requests	요청 횟수 초과	- API 사용 제한 (Rate Limit) 초과

✅ 해결 방법

• 요청을 보낼 때 필수 파라미터가 빠지지 않았는지 확인
• Content-Type 및 헤더 값이 올바른지 확인
• 토큰이 만료되지 않았는지 확인
• API 문서를 참고해 올바른 URL과 HTTP 메서드를 사용

 

 

 

---

 

 

 

🔥 2. 서버 오류 (5xx)

서버에서 요청을 처리하는 도중 발생하는 오류.

500 Internal Server Error	서버 내부 오류	- Java/PHP/Python 등 백엔드 코드 오류 - NullPointerException, SQL 오류
501 Not Implemented	지원되지 않는 기능	- 해당 API가 아직 구현되지 않음
502 Bad Gateway	게이트웨이 오류	- 서버 간 통신 문제 (프록시, 로드 밸런서)
503 Service Unavailable	서버 과부하 또는 다운	- 서버가 너무 많은 요청을 받아 응답할 수 없음
504 Gateway Timeout	서버 응답 시간 초과	- 백엔드 API 응답이 지연됨

✅ 해결 방법

• 서버 로그(catalina.out, error.log) 확인하여 오류 원인 찾기
• DB 연결 문제 (Connection Timeout, Deadlock 등) 확인
• API 서버 재시작 후 다시 테스트

 

 

 

---

 

 

🔎 API 오류 디버깅 방법

 

개발자 도구(F12)에서 네트워크 요청 확인

• 응답 코드 & 에러 메시지 확인

Postman 또는 CURL로 테스트

curl -i -X GET "http://example.com/api/resource"

 

Postman 또는 CURL로 테스트

tail -f /var/log/tomcat/catalina.out

 

API 문서 확인 후 올바른 요청인지 검토

• 필수 파라미터가 누락되었는지 확인
• 인증 토큰이 필요한 API인지 확인