プリフライトで '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 シミュレーター