CORS メソッド不許可 — Allow-Methods

プリフライトで 'Method PUT is not allowed' が出る理由とサーバー設定をシミュレーションで確認。

シナリオプリセット

リクエスト — ブラウザ(ページ)側

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 を使う時点でプリフライト対象になり、Allow-Methods にそのメソッドがなければ 'Method X is not allowed' で本リクエストなしにブロックされます。

よくあるミスは Allow-Methods に GET・POST しか書かないこと、そしてサーバー/プロキシが OPTIONS 自体を 404・405 で拒否することです。

シミュレータで PUT のチェックを入れ外しすると、プリフライト段階で止まり本リクエスト行が出ないのが見えます —「サーバーは正常なのにログに残らない」の典型です。 CORS シミュレーター

よくある質問

Allow-Methods に * は使える?
credentials なしのリクエストでは多くのブラウザが許可しますが、credentials では無視されるため明示列挙が安全です。
サーバーが OPTIONS を 405 で拒否すると?
プリフライト自体が失敗して本リクエストに進みません。OPTIONS を開放し CORS ヘッダー付きの 204 を返してください。

他のシナリオ