'Request header field x-auth-token is not allowed' の原因と Allow-Headers の設定法をシミュレーションで確認。
シナリオプリセット
リクエスト — ブラウザ(ページ)側
Method
Content-Type
カスタムヘッダー
Access-Control-Request-Headers: content-type, x-auth-token
レスポンス — サーバーが返すヘッダー
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: POST Access-Control-Request-Headers: content-type, x-auth-token
サーバーのプリフライト応答が到着
HTTP/1.1 204 No Content Access-Control-Allow-Origin: https://myapp.example.com Access-Control-Allow-Methods: GET, POST, PUT Access-Control-Allow-Headers: content-type
Allow-Origin がオリジンと一致 — 通過
メソッドが Allow-Methods に含まれる — 通過
リクエストヘッダーが Allow-Headers に含まれないx-auth-token
credentials 未使用 — 検査スキップ
ブラウザが応答をブロックし fetch を reject
ブラウザコンソール
✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Request header field content-type is not allowed by Access-Control-Allow-Headers in preflight response.
(index):1
値を変えると下のステップが即座に再計算されます。「credentials + *」シナリオでワイルドカードがなぜ失敗するか確かめてみてください。
Authorization・X-Api-Key のようなカスタムヘッダーや application/json Content-Type は safelist 外で、プリフライトの ACRH に乗ります。Allow-Headers が全部をカバーしなければ 'header field X is not allowed' でブロックされます。
落とし穴は大文字小文字ではなく漏れです — content-type 自体も許可リストに必要だと見落としがちです。authorization だけ書いて content-type が抜けると失敗します。 CORS シミュレーター