CORS 단순 요청 (Simple Request)

어떤 요청이 프리플라이트 없이 바로 전송되는 '단순 요청'인지 조건을 시각화로 확인하세요. GET·POST·safelisted 헤더 규칙과 Access-Control-Allow-Origin 검사 과정을 단계별로 보여줍니다.

시나리오 프리셋

요청 — 브라우저(페이지) 쪽

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
Access-Control-Allow-Origin: https://myapp.example.com

{"status": "ok"}
✓

Allow-Origin이 출처와 일치 — 통과

✓

응답이 JavaScript에 전달됨 — 성공

브라우저 콘솔

▸ 응답이 JavaScript 코드에 정상 전달됐습니다.

값을 바꾸면 아래 단계가 즉시 다시 계산됩니다. 'credentials + *' 시나리오에서 와일드카드가 왜 막히는지 확인해 보세요.

브라우저는 모든 크로스 오리진 요청 앞에 프리플라이트를 보내지 않습니다. 메서드가 GET·HEAD·POST이고, 헤더가 Accept·Accept-Language·Content-Language·Content-Type 같은 safelist 안에 있으며, Content-Type이 text/plain·application/x-www-form-urlencoded·multipart/form-data 중 하나면 '단순 요청'으로 바로 본 요청이 나갑니다.

단순 요청이라도 안전장치는 있습니다. 응답이 도착한 뒤 브라우저가 Access-Control-Allow-Origin을 검사해 출처와 맞지 않으면 JavaScript에는 응답이 전달되지 않습니다. 요청은 서버에 도달하지만 응답을 '읽지 못하는' 구조입니다.

fetch의 mode나 credentials 옵션과 무관하게, GET + 표준 헤더 조합은 항상 단순 요청입니다. 반대로 application/json 하나만 넣어도 단순 요청에서 벗어나 프리플라이트가 필요해집니다 — 이 시뮬레이터에서 Content-Type을 바꿔보면 단계가 달라지는 걸 확인할 수 있습니다. CORS 시뮬레이터에서 다른 시나리오도 같은 설정으로 비교해 보세요.

자주 묻는 질문

단순 요청인데도 CORS 에러가 나는 이유는?
프리플라이트가 없어도 본 응답의 Access-Control-Allow-Origin 검사는 합니다. 헤더가 없거나 출처가 다르면 브라우저가 응답을 차단합니다. 서버 로그에는 요청이 남으므로 '요청은 갔는데 왜 에러?'가 되는 것입니다.
application/json을 쓰면 왜 프리플라이트가 생기나요?
Content-Type의 safelist는 text/plain·form-urlencoded·multipart/form-data뿐입니다. application/json은 목록에 없어 비단순 헤더로 취급되고, 프리플라이트에서 서버가 content-type을 허용하는지 먼저 확인합니다.

다른 시나리오 보기