Error Guide
HTTP 401 / 403 Unauthorized & Forbidden
401은 인증 실패, 403은 권한 부족을 의미합니다.
HTTP401403
에러 메시지 예시
401 Unauthorized
403 Forbidden무슨 의미인가요?
401은 인증 실패, 403은 권한 부족을 의미합니다.
자주 발생하는 원인
- 인증 토큰 누락
- 세션/토큰 만료
- 권한(Role/Scope) 제한
- API 키 오류
빠른 해결 방법
- 사용자를 다시 인증합니다.
- 토큰을 갱신합니다.
- Authorization 헤더를 확인합니다.
- 권한/역할 정책을 검토합니다.
확인 방법
요청을 다시 시도하고 상태 코드가 200으로 바뀌는지 확인합니다.
예제 코드
// fetch 예시
const res = await fetch('/api/secure', {
headers: { Authorization: `Bearer ${token}` },
});
if (res.status === 401) {
// 다시 인증
}
if (res.status === 403) {
// 권한 부족
}FAQ
Q. 401과 403의 차이는?
A. 401은 인증 실패, 403은 권한 부족입니다.
Q. 403은 클라이언트에서 해결할 수 있나요?
A. 대부분 서버 권한 설정 변경이 필요합니다.