CORSエラーの原因と直し方|サーバーは返事をしているのに、ブラウザが受け取りを止めている
「blocked by CORS policy」は、通信の失敗ではない。
直すのはJavaScriptではなく、APIを返すサーバーのヘッダーだ。
fetchでAPIを呼んだら、コンソールに「has been blocked by CORS policy」と出て、データが取れない。
このエラーは、サーバーが答えを返していないのではなく、返ってきた答えをブラウザが捨てている状態だ。
直すのはJavaScriptではなく、APIを返すサーバーの側で、Access-Control-Allow-Origin というヘッダーを付ける。
今日、手元のパソコンで2つのポートを立てて、実際にこのエラーを出して確かめた。
試したこと
ページを http://localhost:8701 で出し、そこから http://localhost:8702 のAPIをfetchで呼んだ。
どちらも同じパソコンの中だが、ポート番号が違う。
API側には、届いたリクエストを全部ログに出すようにしておいた。
ブラウザはChrome系のブラウザで、2026-11-13に試している。
試した組み合わせは3つ。
- API側がヘッダーを付けずに、GETで呼ぶ
- API側が
Access-Control-Allow-Origin: http://localhost:8701を付けて、GETで呼ぶ - ヘッダーは付けたまま、
Content-Type: application/jsonを付けてPOSTで呼ぶ
結果1:ヘッダーが無いと、届いているのに読めない
1つ目のコンソールには、次の文が出た。
Access to fetch at 'http://localhost:8702/data' from origin 'http://localhost:8701'
has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present
on the requested resource.ところがAPI側のログを見ると、GETはちゃんと届いていて、サーバーは200で中身を返していた。
同じURLをcurlで叩くと、中身はそのまま表示される。
curlはブラウザではないので、この制限を受けない。
つまり、通信が失敗したのではない。
ブラウザが「このページのscriptに、この答えを渡してよいか」をヘッダーで確かめて、許可が無いので捨てた。
CORSのエラーは、ここを取り違えると直し方を探し回ることになると僕は思う。
JavaScriptからは、理由が見えない
fetchのcatchに入ってきたのは「TypeError: Failed to fetch」だけだった。
ヘッダーが無いのか、サーバーが落ちているのか、JavaScriptからは区別がつかない。
MDNのCORSの解説にも、セキュリティ上の理由で、何が失敗したのかはJavaScriptから知ることができないと書かれている。
分かるのはエラーが起きたことだけで、詳しい理由はブラウザのコンソールで見る。
catchでログを出して首をひねるより、先に開発者ツールのコンソールを見るのが早い。
そもそも「オリジン」が違うとは
MDNの同一オリジンポリシーの説明では、プロトコル・ホスト・ポート番号の3つが全部同じなら「同じオリジン」になる。
1つでも違えば別のオリジンだ。
http://localhost:8701とhttp://localhost:8702:ポートが違うので別https://example.comとhttp://example.com:プロトコルが違うので別https://example.comとhttps://api.example.com:ホストが違うので別
開発中に、画面はVite、APIはPHPのように別々のポートで動かすと、それだけでこのエラーに当たる。
本番では同じドメインにまとめていて起きなかったのに、手元でだけ起きる、ということがある。
直し方:API側でヘッダーを返す
2つ目の試しでは、API側の返事に次の1行を足しただけで、データがそのまま取れた。
Access-Control-Allow-Origin: http://localhost:8701MDNによると、値には許可するオリジンを1つ書くか、どこからでもよいなら * を書く。
複数のオリジンを許したい時は、リクエストのOriginを見て、許可リストにあればそのオリジンを返す。
その時は Vary: Origin も付けて、キャッシュが別のオリジン向けの答えを使い回さないようにする、とMDNにある。
PHPならこう書ける。
header('Access-Control-Allow-Origin: https://www.example.com');
header('Vary: Origin');
header('Content-Type: application/json; charset=utf-8');Cookieを付けて送るリクエスト(fetchに credentials: 'include' を付ける時)は、* が使えない。
MDNには、資格情報つきのリクエストでワイルドカードを返すとエラーになると書かれている。
この場合は、オリジンを具体的に書く必要がある。
結果2:POSTでJSONを送ると、先に「下見」が飛ぶ
3つ目の試しは、ヘッダーを付けたのに、また止まった。
コンソールの文は1つ目と違っていた。
Access to fetch at 'http://localhost:8702/json?allow=1' from origin 'http://localhost:8701'
has been blocked by CORS policy: Request header field content-type is not allowed by
Access-Control-Allow-Headers in preflight response.API側のログには、POSTが1回も来ていなかった。
代わりに届いていたのは、OPTIONSというリクエストが1回だけだった。
これがプリフライト(下見)だ。
MDNによると、メソッドがGET・HEAD・POSTのどれかで、Content-Typeが application/x-www-form-urlencoded・multipart/form-data・text/plain のどれかなら、下見なしで送られる。
JSONを送るために application/json を付けると、この条件から外れる。
するとブラウザは本番のPOSTの前にOPTIONSで「このヘッダーを付けて送ってもよいか」を聞き、許可の返事が無ければ、POSTそのものを送らない。
直すには、OPTIONSへの返事に、許すヘッダーとメソッドを書く。
Access-Control-Allow-Origin: https://www.example.com
Access-Control-Allow-Methods: GET, POST
Access-Control-Allow-Headers: Content-TypePHPなら、リクエストのメソッドがOPTIONSの時だけこの3行を返して、本体の処理をせずに終わらせる形が分かりやすいと思う。
やってはいけない直し方
検索すると、ブラウザの拡張機能でCORSを切る方法や、起動オプションでセキュリティを外す方法が出てくる。
手元で一瞬試すだけならいいが、それで直ったように見えても、ほかの人のブラウザでは同じエラーが出る。
直す場所は、あくまでAPIを返すサーバーだ。
他社のAPIで、自分ではヘッダーを足せない場合もある。
その時は、自分のサーバーのPHPからそのAPIを呼んで、結果を自分のページに渡す形にする。
サーバー同士の通信はブラウザを通らないので、CORSの制限を受けない。
APIキーをブラウザに出さずに済むので、僕はこちらの形のほうが安心だと思う。
MDNは、Access-Control-Allow-Origin: null も使わないように注意している。
data: や file: のページもnullのオリジンになるため、許したつもりのない相手まで通してしまうからだ。
エラーの文から当たりをつける
- No 'Access-Control-Allow-Origin' header is present:API側がヘッダーを返していない。まずサーバーの返事にヘッダーを足す
- is not allowed by Access-Control-Allow-Headers in preflight response:下見のOPTIONSで、ヘッダーの許可が足りない。Allow-Headersを足す
- must not be the wildcard '*' when the request's credentials mode is 'include':Cookieつきなのに
*を返している。オリジンを具体的に書く(これも今回、credentialsを付けて試して同じ文が出た)
どれも、JavaScriptを書き直しても直らない。
fetchの失敗がCORSでなく、404のようなHTTPのエラーだった時の扱いは、fetchが404でもcatchに入らない原因に書いた。
ポート番号でオリジンが変わる仕組みは、ポート番号の仕組みで詳しく書いている。
出典
ほかにも書いています
受託・note・スタンプこういう仕組みを作る相談を受けています
毎日の更新・データ集め・集計の自動化/3万円〜収益がいくらだったか、どの施策が外れたか
note / 個人の視点で掘り下げていますスタンプラリーに挑戦する
行った場所は、現地チェックインで記録に残せます※受託の相談とnoteは、運営者が個人で受けている・書いているものです。
