CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題)

要点

ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。

何が起きているか

  • オリジン = プロトコル+ドメイン+ポート(https://example.com)。1つでも違えば別オリジン(https://api.example.com、http://example.com も別)。
  • ブラウザは安全のため、あるサイトのJavaScriptが別オリジンの応答を読むことを制限している。
  • 相手のサーバーが応答ヘッダーで Access-Control-Allow-Origin: https://自サイト のように許可していれば読める。許可がないと Console に次のような赤いエラー: Access to fetch at '...' from origin '...' has been blocked by CORS policy
  • 送信方法やヘッダーによっては、本番の前に確認のリクエスト(OPTIONS、プリフライト)が送られ、その応答で許可されないと本体も送られない。

よくある誤解

  • 「ブラウザ側のコードを直せば必ず解決する」わけではない。 許可するかどうかは相手(API側)のサーバーが決める。
  • mode: 'no-cors' にするとエラーは消えるが、応答の中身は読めない(解決ではない)。
  • サーバーから(PHP・curl)呼ぶと成功するのは、CORSがブラウザだけの制限だから。

解決の方向

状況方向
自分が管理するAPIAPI側で自サイトのオリジンを許可する設定を入れる(* で全部許可は、認証付きAPIでは避ける)
外部サービスのAPIそのサービスがブラウザからの利用を許可しているか確認。管理画面で許可ドメインを登録する方式もある
ブラウザからの利用が想定されていないAPI自分のサーバー(WordPressの処理など)経由で呼ぶ。秘密のキーもサーバー側に置ける(APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ))

iframe とは別問題

エラーの確認場所は Console と Network(DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない)、DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ))。