가장 흔한 CORS 에러 'No Access-Control-Allow-Origin header is present'가 어떤 단계에서 발생하는지 시뮬레이션으로 확인하고, 서버에 어떤 헤더를 추가해야 하는지 알아보세요.
시나리오 프리셋
요청 — 브라우저(페이지) 쪽
Method
Content-Type
커스텀 헤더
응답 — 서버가 보내는 헤더
Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers
요청에 필요한 헤더 + 자주 쓰는 값 — 클릭으로 토글
브라우저 처리 단계
페이지에서 fetch 요청 발생
단순 요청(CORS-safelisted) — 프리플라이트 없이 바로 전송
본 요청 전송
GET /data HTTP/1.1 Origin: https://myapp.example.com Content-Type: text/plain
서버의 본 응답 도착
HTTP/1.1 200 OK
{"status": "ok"}응답에 Access-Control-Allow-Origin 헤더 없음
브라우저가 응답을 차단하고 fetch를 reject
브라우저 콘솔
✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
(index):1
값을 바꾸면 아래 단계가 즉시 다시 계산됩니다. 'credentials + *' 시나리오에서 와일드카드가 왜 막히는지 확인해 보세요.
'Access to fetch ... has been blocked by CORS policy: No Access-Control-Allow-Origin header'는 CORS 에러의 대표입니다. 요청은 정상적으로 서버에 도달하고 처리되지만, 응답에 Access-Control-Allow-Origin 헤더가 없어 브라우저가 그 응답을 JavaScript에 넘겨주지 않는 것입니다.
핵심은 차단 주체가 서버가 아니라 브라우저라는 점입니다. curl이나 Postman으로는 같은 요청이 잘 되는 이유가 여기 있습니다 — CORS는 브라우저가 사용자를 보호하기 위해 응답 읽기를 막는 정책이지, 서버가 요청을 거부하는 게 아닙니다.
해결은 서버에서 응답 헤더를 추가하는 것뿐입니다. 특정 출처만 허용할지(Access-Control-Allow-Origin: https://myapp.com), 전체 공개할지(*)는 API 성격에 따라 결정하세요. 프록시 우회나 no-cors 모드는 임시방편일 뿐 근본 해결이 아닙니다. CORS 시뮬레이터에서 다른 시나리오도 같은 설정으로 비교해 보세요.