JavaScriptのfetchで出るCORSエラーの原因と直し方
ブラウザーの JavaScript から別のドメインの API に fetch() したとき、コンソールに blocked by CORS policy と出るのは、API の応答に、そのページからの読み取りを許すヘッダー(Access-Control-Allow-Origin など)がないためです。直すのはブラウザーで動くコードではなく、API のサーバーの側です。
フロントエンドと API を別のドメインやポートで動かしていて、画面から API を呼ぶと失敗するのに、curl で同じ URL を開くと結果が返る、という場面の話です。私は検証環境でこのエラーをわざと起こし、出たメッセージと、サーバーにヘッダーを足すと消えることを確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0 で起動した Chromium 153.0.8010.12(ヘッドレス)です。Chromium の --host-resolver-rules で app.example.com と api.example.com を自分のマシン(127.0.0.1)に向け、コンソールの出力は Playwright で取り出しました。Chrome の DevTools の画面での表示や、Firefox・Safari では確かめていません。Cookie を送る credentials: 'include' の場合も扱っていません。
エラーを起こした構成
画面を配るサーバーを http://app.example.com:8080、API のサーバーを http://api.example.com:8081 で動かしました。どちらも Node.js の node:http で書いています。最初の API は、CORS のことを何もしていない、次のコードです。
// API のサーバー(http://api.example.com:8081)。CORS の設定なし
import { createServer } from 'node:http';
createServer((req, res) => {
console.log(req.method, req.url, 'Origin:', req.headers.origin);
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ items: ['りんご', 'みかん'] }));
}).listen(8081);
画面(http://app.example.com:8080/)では、この API を fetch() で呼び、結果か、失敗したときのエラーを <pre id="out"> に表示します。
async function getItems() {
try {
const res = await fetch('http://api.example.com:8081/items');
out.textContent = JSON.stringify(await res.json());
} catch (err) {
out.textContent = String(err);
}
}
ブラウザーでは、スキーム(http)、ホスト、ポートの3つがすべて同じときだけ「同じオリジン」とみなされます(MDN の同一オリジンポリシーの説明)。この構成では、ホストもポートも違うので、画面と API は別のオリジンです。ホストが同じ localhost でも、ポートが違えば別のオリジンになります。
GET で出たメッセージ
getItems() を呼ぶと、コンソールに次の2行が出ました。
Access to fetch at 'http://api.example.com:8081/items' from origin 'http://app.example.com:8080' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
Failed to load resource: net::ERR_FAILED
1行目は、http://app.example.com:8080 のページから http://api.example.com:8081/items への fetch を、応答に Access-Control-Allow-Origin ヘッダーがないのでブラウザーが止めた、という意味です。画面に表示されたのは、fetch() が投げたエラーの次の文字列だけでした。
TypeError: Failed to fetch
JavaScript のコードの側では、どの理由で失敗したのかは分かりません。MDN の CORS の説明にも、セキュリティのために CORS の失敗の詳細は JavaScript に渡されず、何が悪いのかはブラウザーのコンソールを見るしかない、とあります。catch で受け取ったエラーを調べるより、コンソールの1行目を読むほうが早く原因にたどり着けます。
リクエストはサーバーに届いている
このとき、API のサーバーのターミナルには、ブラウザーからのリクエストで次の1行が出ていました。
GET /items Origin: http://app.example.com:8080
ブラウザーはリクエストを送り、サーバーは応答を返しています。止められたのは、その応答をページの JavaScript が読むことです。ブラウザーは、CORS の確認が必要な別のオリジンへのリクエストには、送り元のオリジンを Origin ヘッダーで付けます。
curl には、応答を読ませるかどうかをブラウザーのように確かめる仕組みがありません。同じ Origin ヘッダーを付けて curl で呼ぶと、応答はそのまま返りました。
$ curl -s -i -H 'Origin: http://app.example.com:8080' --resolve api.example.com:8081:127.0.0.1 http://api.example.com:8081/items
HTTP/1.1 200 OK
Content-Type: application/json
Date: Wed, 11 Nov 2026 12:27:38 GMT
Connection: keep-alive
Keep-Alive: timeout=5
Content-Length: 35
{"items":["りんご","みかん"]}
応答のヘッダーに Access-Control-Allow-* が1つもないことが、ここから分かります。ブラウザーはこのヘッダーがないので応答をページに渡さず、curl は確かめないのでそのまま表示します。
JSON を送る POST では、メッセージが変わる
次に、JSON を送る POST を試しました。
const res = await fetch('http://api.example.com:8081/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: 'りんご' }),
});
同じ API に対して、コンソールには次のように出ました。
Access to fetch at 'http://api.example.com:8081/items' from origin 'http://app.example.com:8080' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.
Failed to load resource: net::ERR_FAILED
今度は Response to preflight request doesn't pass access control check が入っています。サーバーのターミナルに出たのは、POST ではなく次の1行だけでした。
OPTIONS /items Origin: http://app.example.com:8080
Content-Type が application/json のリクエストは、本来のリクエストを送る前に、ブラウザーが OPTIONS メソッドで「このリクエストを送ってよいか」をサーバーに問い合わせます。これをプリフライトリクエストと呼びます。問い合わせをしなくてよいのは、メソッドが GET・HEAD・POST で、Content-Type が application/x-www-form-urlencoded、multipart/form-data、text/plain のどれか、などの条件をすべて満たすときだけです(MDN の単純リクエストの条件)。この検証では、プリフライトの応答に許可のヘッダーがなかったので、POST は送られませんでした。
GET だけ通るようにしても、POST は止まる
API の応答に Access-Control-Allow-Origin を足しました。プリフライトの OPTIONS には、中身のない 204 を返します。
// Access-Control-Allow-Origin だけを付けた版(Access-Control-Allow-Headers なし)
import { createServer } from 'node:http';
createServer((req, res) => {
console.log(req.method, req.url, 'Origin:', req.headers.origin);
res.setHeader('Access-Control-Allow-Origin', 'http://app.example.com:8080');
if (req.method === 'OPTIONS') {
res.statusCode = 204;
res.end();
return;
}
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ items: ['りんご', 'みかん'] }));
}).listen(8081);
これで GET のエラーは消え、画面には {"items":["りんご","みかん"]} と表示されました。一方、POST は、まだ次のメッセージで止まりました。
Access to fetch at 'http://api.example.com:8081/items' from origin 'http://app.example.com:8080' has been blocked by CORS policy: Request header field content-type is not allowed by Access-Control-Allow-Headers in preflight response.
Failed to load resource: net::ERR_FAILED
プリフライトの応答の Access-Control-Allow-Headers に、リクエストで付けた Content-Type ヘッダーが入っていない、という意味です。MDN にある、Firefox での同じエラーの説明のとおり、サーバーがそのヘッダーを許すか、そのヘッダーを使わないようにすると直ります。POST を試したときも、サーバーのターミナルには OPTIONS /items だけが出て、POST は届いていませんでした。
プリフライトにも答えるようにすると、エラーが消える
最後に、プリフライトの応答に、使ってよいメソッドとヘッダーを足しました。
// CORS の設定を入れた版
import { createServer } from 'node:http';
const ALLOWED_ORIGIN = 'http://app.example.com:8080';
createServer(async (req, res) => {
console.log(req.method, req.url, 'Origin:', req.headers.origin);
if (req.headers.origin === ALLOWED_ORIGIN) {
res.setHeader('Access-Control-Allow-Origin', ALLOWED_ORIGIN);
res.setHeader('Vary', 'Origin');
}
if (req.method === 'OPTIONS') {
// プリフライトリクエストへの応答
res.setHeader('Access-Control-Allow-Methods', 'GET, POST');
res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
res.statusCode = 204;
res.end();
return;
}
res.setHeader('Content-Type', 'application/json');
if (req.method === 'POST') {
let body = '';
for await (const chunk of req) body += chunk;
res.end(JSON.stringify({ added: JSON.parse(body).name }));
return;
}
res.end(JSON.stringify({ items: ['りんご', 'みかん'] }));
}).listen(8081);
この API に対して、GET と POST のどちらでもコンソールにはエラーが出ませんでした。画面には、GET では {"items":["りんご","みかん"]}、POST では {"added":"りんご"} と表示されました。サーバーのターミナルに出たブラウザーからのリクエストは次の3行で、POST の前にプリフライトが届いています。
GET /items Origin: http://app.example.com:8080
OPTIONS /items Origin: http://app.example.com:8080
POST /items Origin: http://app.example.com:8080
それぞれのヘッダーの役目は、MDN の CORS の応答ヘッダーの一覧にあります。Access-Control-Allow-Origin は読み取りを許すオリジンを、Access-Control-Allow-Methods と Access-Control-Allow-Headers は、プリフライトの応答で、本来のリクエストに使ってよいメソッドとヘッダーを伝えます。* を書けばどのオリジンからも読めるようになりますが、MDN にある、Access-Control-Allow-Origin がないときのエラー(Firefox の表示)の説明では、* は公開の API だけに使い、そうでない API には特定のドメインを書くように、とされています。このコードのようにオリジンを1つに決めて返すときは Vary: Origin も付けるように、MDN の Access-Control-Allow-Origin のページに書かれています。
プリフライトの応答は、curl でも確かめられます。ブラウザーと同じように Access-Control-Request-Method と Access-Control-Request-Headers を付けて OPTIONS を送ると、次の応答が返りました。
$ curl -s -i -X OPTIONS -H 'Origin: http://app.example.com:8080' -H 'Access-Control-Request-Method: POST' -H 'Access-Control-Request-Headers: content-type' --resolve api.example.com:8081:127.0.0.1 http://api.example.com:8081/items
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: http://app.example.com:8080
Vary: Origin
Access-Control-Allow-Methods: GET, POST
Access-Control-Allow-Headers: Content-Type
Date: Wed, 11 Nov 2026 12:27:48 GMT
Connection: keep-alive
Keep-Alive: timeout=5
ブラウザーで失敗するときは、エラーのメッセージで足りないと言われたヘッダーが、この curl の応答に入っているかを見ます。入っていれば、サーバーの設定は効いています。
mode: 'no-cors' を付けても、データは読めない
エラーが出ないようにしようとして、fetch() に mode: 'no-cors' を付けることがあります。CORS の設定がない最初の API を、次のように呼んでみました。
const res = await fetch('http://api.example.com:8081/items', { mode: 'no-cors' });
out.textContent = `type: ${res.type}, status: ${res.status}, body: "${await res.text()}"`;
コンソールにエラーは出ませんでしたが、画面の表示は次のとおりで、中身は空でした。
type: opaque, status: 0, body: ""
MDN の CORS エラーのページにあるとおり、no-cors の応答は中身を読めない opaque な応答になり、ステータスは 0、ヘッダーは空、本文は JavaScript から読めません。アクセス解析のビーコンのように、送るだけで応答を使わないときのためのものです。
API の応答を画面で使いたいなら、直すのはサーバーの側です。自分で API に手を入れられないときは、MDN のページで、自分で管理するサーバーを間に置き、そこから API を呼んで、CORS のヘッダーを付けて返す方法が紹介されています。




