🌐 [WEB Error] 401 / 403 / 500 / 504 완전 정리 (초보자용)

 

 

 

웹사이트를 사용하다 보면 이런 에러를 많이 보셨을 겁니다.

401 Unauthorized
403 Forbidden
500 Internal Server Error
504 Gateway Timeout

 

👉 이 숫자들은 단순한 에러가 아니라
“문제가 어디에서 발생했는지 알려주는 힌트” 입니다.

---

📌 1. 한 번에 이해하는 핵심 요약

딱 이것만 먼저 기억하세요 👇

코드	의미	한 줄 설명
401	인증 실패	“너 누구야?”
403	권한 없음	“너는 맞는데 못 들어와”
500	서버 오류	“서버가 터졌어”
504	시간 초과	“너무 느려서 포기함”

---

📌 2. 웹 요청 흐름 먼저 이해하기

웹 에러는 요청 흐름을 이해하면 훨씬 쉽습니다.

[사용자] → [웹서버(Nginx)] → [백엔드(API)] → [DB]

 

👉 어디에서 문제가 생기느냐에 따라 에러가 달라집니다.

---

🔐 3. 401 Unauthorized (인증 실패)

✔ 의미

👉 “당신이 누구인지 모르겠어요”

✔ 쉽게 설명

• 로그인 안 했음
• 토큰 없음
• 토큰 만료됨

✔ 예시

• 로그인 없이 마이페이지 접근
• 만료된 JWT로 API 호출

✔ 특징

• 인증 자체가 안 된 상태
• 로그인 문제

✔ 해결 방법

👤 사용자

• 다시 로그인
• 앱 재시작

👨‍💻 개발자

• Authorization 헤더 확인
• 토큰 만료(exp) 확인
• 쿠키 전달 여부 확인

✔ 한 줄 정리

👉 “로그인 안 해서 막힘”

---

🚫 4. 403 Forbidden (권한 없음)

✔ 의미

👉 “누군지는 알겠는데, 접근 못 합니다”

✔ 쉽게 설명

• 로그인은 했음
• 하지만 권한 없음

✔ 예시

• 일반 유저가 /admin 접근
• 회사 내부 시스템 외부에서 접근

✔ 특징

• 인증은 성공
• 권한 부족 문제

✔ 해결 방법

👤 사용자

• 관리자에게 권한 요청

👨‍💻 개발자

• RBAC 권한 확인
• WAF 차단 여부 확인
• 서버 접근 정책 확인

✔ 한 줄 정리

👉 “너는 맞는데, 들어오면 안 됨”

---

⚠️ 5. 500 Internal Server Error (서버 오류)

✔ 의미

👉 “서버 내부에서 오류 발생”

✔ 쉽게 설명

• 요청은 정상
• 서버가 처리하다가 실패

✔ 대표 원인

• 코드 버그
• DB 연결 실패
• 환경변수 오류
• 메모리 부족

✔ 예시

• 회원가입 시 서버 에러
• API 호출 시 갑자기 실패

✔ 특징

• 가장 흔한 에러
• 원인은 다양함

✔ 해결 방법

👤 사용자

• 새로고침
• 잠시 후 재시도

👨‍💻 개발자

• 서버 로그 확인 (핵심!)
• 최근 배포 확인
• DB 상태 확인

✔ 한 줄 정리

👉 “서버가 내부에서 터짐”

---

⏱️ 6. 504 Gateway Timeout (시간 초과)

✔ 의미

👉 “서버 응답이 너무 늦음”

✔ 쉽게 설명

• 요청은 갔음
• 근데 응답이 너무 늦음

✔ 예시

• DB 쿼리 너무 느림
• 외부 API 응답 없음
• 서버 과부하

✔ 특징

• 속도 문제
• 트래픽 많을 때 자주 발생

✔ 해결 방법

👤 사용자

• 다시 시도
• 잠시 기다리기

👨‍💻 개발자

• 느린 쿼리 확인
• 서버 성능 확인
• timeout 설정 확인

✔ 한 줄 정리

👉 “느려서 기다리다 포기함”

---

🔥 7. 가장 많이 헷갈리는 비교

401 vs 403

구분	401	403
상태	인증 실패	권한 없음
의미	로그인 안됨	로그인 했지만 접근 불가

👉 핵심

• 401 → 로그인 문제
• 403 → 권한 문제

---

500 vs 504

구분	500	504
원인	내부 오류	느림
위치	서버 내부	서버 간 통신

👉 핵심

• 500 → 서버가 터짐
• 504 → 서버가 너무 느림

---

🧠 8. 초보자용 장애 분석 순서

이 순서만 기억하세요 👇

1단계: 에러 코드 확인

• 401?
• 403?
• 500?
• 504?

2단계: 문제 위치 파악

• 인증 문제 → 401
• 권한 문제 → 403
• 서버 내부 → 500
• 속도 문제 → 504

3단계: 로그 확인 위치

에러	확인 위치
401	인증 서버
403	권한/WAF
500	앱 로그
504	Nginx/LB

---

🚀 9. 실무에서 바로 쓰는 판단법

✔ 401 많다?

👉 로그인/토큰 문제

✔ 403 많다?

👉 권한 정책 문제

✔ 500 많다?

👉 코드/서버 문제

✔ 504 많다?

👉 성능/속도 문제

---

🎯 10. 최종 한 줄 정리 (암기용)

이거 하나만 외우면 끝입니다 👇

401 → 나를 증명 못함
403 → 나를 알지만 막음
500 → 서버가 터짐
504 → 서버가 너무 느림

 

---

💡 마무리

웹 에러는 어렵게 느껴지지만, 사실은 단순합니다.

👉 핵심은 단 하나

“문제가 어디서 발생했는지 구분하는 것”

• 인증 문제 → 401
• 권한 문제 → 403
• 서버 문제 → 500
• 속도 문제 → 504