Ch.8 웹 개발 상식
흔한 에러들 — CORS, 404, 500 해결법
개발하다 보면 반드시 만나는 에러 3형제가 있습니다
웹사이트를 만들고 있는데 갑자기 빨간 에러 메시지가 뜹니다. CORS, 404, 500. 뭔가 무섭고 복잡해 보이지만, 사실 각각의 의미와 해결법은 명확합니다.
에러 메시지를 무시하거나 두려워하면 문제가 커집니다. 하지만 에러를 읽을 줄 알면 해결의 실마리가 보입니다.
흔한 에러 3가지의 원인과 해결법을 익히면 당황하지 않고 AI에게 정확한 단서를 전달할 수 있습니다.
핵심 내용
에러는 적이 아니라 단서입니다. 에러 메시지를 읽으면 원인과 해결책이 보입니다. 무시하거나 두려워하지 말고, 메시지를 꼼꼼히 읽는 습관이 중요합니다.
에러 메시지 = AI에게 전달할 최고의 단서
CORS 에러 — 개발자가 가장 혼란스러워하는 에러입니다. 처음 만나면 무슨 소리인지 전혀 모르지만, 원리는 간단합니다.
CORS = Cross-Origin Resource Sharing 브라우저의 보안 정책입니다. 다른 도메인(origin)의 API를 호출하면 차단됩니다. 예: `localhost:3000`에서 `api.example.com`을 호출 → CORS 에러 해결 방법 3가지: 1. 서버에서 `Access-Control-Allow-Origin` 헤더 추가 2. Next.js API Routes로 프록시 (같은 도메인으로 우회) 3. AI에게 "CORS 에러가 나요, 해결해줘"라고 에러 메시지와 함께 전달
에러 전달 공식 AI에게 에러를 전달할 때 이 3가지를 포함하면 해결률이 급상승합니다. 1. 에러 메시지 전문 — 복사 붙여넣기 (요약하지 말 것) 2. 어떤 동작을 했을 때 — "로그인 버튼을 눌렀을 때" 3. 기대한 동작 — "대시보드로 이동해야 하는데 에러 발생"
서버 코드의 버그로 발생하는 HTTP 에러 코드는?
CORS 에러는 프론트엔드 코드를 수정해서 해결할 수 있다
핵심 용어
404 Not Found
요청한 페이지/API가 없음. URL 오타, 파일 누락이 원인. 경로를 확인하세요
500 Internal Server Error
서버 코드에 버그. null 참조, DB 연결 실패 등이 원인. 서버 로그를 확인하세요
핵심 정리
- 1CORS = 브라우저 보안 정책 → 서버 헤더 추가 또는 프록시로 해결
- 2404 = 경로 없음(URL 확인), 500 = 서버 버그(로그 확인)
- 3에러 전달 공식: 메시지 전문 + 동작 설명 + 기대 동작
- 4에러는 적이 아니라 단서 — 메시지를 읽는 습관이 핵심
퀴즈와 인터랙션으로 더 깊이 학습하세요
play_circle인터랙티브 레슨 시작