CORS 메서드 거부 — Allow-Methods

프리플라이트에서 'Method PUT is not allowed by Access-Control-Allow-Methods'가 발생하는 이유와 서버 설정법을 시뮬레이션으로 확인하세요.

시나리오 프리셋

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

Method

Content-Type

커스텀 헤더

Access-Control-Request-Headers: content-type

응답 — 서버가 보내는 헤더

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

요청에 필요한 헤더 + 자주 쓰는 값 — 클릭으로 토글

브라우저 처리 단계

→

페이지에서 fetch 요청 발생

•

단순 요청이 아님 — OPTIONS 프리플라이트 필요

→

OPTIONS 프리플라이트 요청 전송

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: PUT
Access-Control-Request-Headers: content-type
←

서버의 프리플라이트 응답 도착

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST
Access-Control-Allow-Headers: content-type
✓

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

✗

요청 메서드가 Allow-Methods에 없음PUT

✓

요청 헤더가 Allow-Headers에 모두 포함 — 통과

—

credentials 미사용 — 검사 생략

✗

브라우저가 응답을 차단하고 fetch를 reject

브라우저 콘솔

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Method content-type is not allowed by Access-Control-Allow-Methods in preflight response.

(index):1

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

PUT·DELETE·PATCH를 쓰는 순간 요청은 프리플라이트 대상이 되고, 서버가 Access-Control-Allow-Methods에 그 메서드를 명시하지 않으면 브라우저는 'Method X is not allowed'로 본 요청 없이 차단합니다. API에는 PUT 엔드포인트가 분명히 있는데도 실패하는 이유는 서버의 CORS 허용 목록이 요청을 못 따라간 것입니다.

자주 하는 실수는 허용 목록에 GET·POST만 넣는 것과, OPTIONS 자체를 막는 것입니다. 프리플라이트 자체가 OPTIONS 메서드이므로 서버(또는 리버스 프록시)가 OPTIONS를 405·404로 거절하면 프리플라이트는 시작부터 실패합니다.

이 시뮬레이터에서 Allow-Methods의 PUT 체크를 껐다 켰다 해보면 실패 단계가 프리플라이트에서 멈추는 것, 그리고 본 요청 라인이 아예 안 나오는 것을 볼 수 있습니다 — '서버는 멀쩡한데 호출 로그가 없다'는 브라우저 단계 차단의 전형입니다. CORS 시뮬레이터에서 다른 시나리오도 같은 설정으로 비교해 보세요.

자주 묻는 질문

Allow-Methods에 *를 써도 되나요?
credentials가 없는 요청에서는 대부분 브라우저가 허용합니다. 다만 credentials: include 요청에서는 와일드카드가 무시되므로 메서드를 명시해야 합니다. 관행적으로 필요한 메서드만 나열하는 게 안전합니다.
OPTIONS 요청을 서버가 405로 거절하면?
프리플라이트 자체가 실패해 본 요청까지 가지 못합니다. 서버나 nginx에서 OPTIONS를 열어두고 CORS 헤더를 붙여 204를 반환해야 합니다.

다른 시나리오 보기