2026.09.23 泊まれる場所4,223 立ち寄りスポット59,693 営業中を確認したキャンプ場1,005 note を読む

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:8701

MDNによると、値には許可するオリジンを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-Type

PHPなら、リクエストのメソッドが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に入らない原因に書いた。
ポート番号でオリジンが変わる仕組みは、ポート番号の仕組みで詳しく書いている。

出典

まる子パパ

まる子パパ

会社員。受託開発のエンジニアを15年以上続けていて、その前は寿司職人・長距離運転手・農業。 技術ブログは、キャンプの合間に踏んだバグと、AI・Web開発の運用の失敗を書いています。 このサイト自体が、開発に携わっているCMS「コンテナ」の稼働中の実例です。 このサイトについて / 小さな自動化の相談

—

ほかにも書いています

受託・note・スタンプ

※受託の相談とnoteは、運営者が個人で受けている・書いているものです。

技術ブログ一覧へ戻る