프리플라이트에서 '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 시뮬레이터에서 다른 시나리오도 같은 설정으로 비교해 보세요.