JavaScriptのfetchで出るCORSエラーの原因と直し方

​​JavaScript​Chromium,Node.js,トラブルシュート

ブラウザーの 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 のことを何もしていない、次のコードです。

js
// 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"> に表示します。

js
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行が出ました。

text
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() が投げたエラーの次の文字列だけでした。

text
TypeError: Failed to fetch

JavaScript のコードの側では、どの理由で失敗したのかは分かりません。MDN の CORS の説明にも、セキュリティのために CORS の失敗の詳細は JavaScript に渡されず、何が悪いのかはブラウザーのコンソールを見るしかない、とあります。catch で受け取ったエラーを調べるより、コンソールの1行目を読むほうが早く原因にたどり着けます。

リクエストはサーバーに届いている

このとき、API のサーバーのターミナルには、ブラウザーからのリクエストで次の1行が出ていました。

text
GET /items Origin: http://app.example.com:8080

ブラウザーはリクエストを送り、サーバーは応答を返しています。止められたのは、その応答をページの JavaScript が読むことです。ブラウザーは、CORS の確認が必要な別のオリジンへのリクエストには、送り元のオリジンを Origin ヘッダーで付けます。

curl には、応答を読ませるかどうかをブラウザーのように確かめる仕組みがありません。同じ Origin ヘッダーを付けて curl で呼ぶと、応答はそのまま返りました。

console
$ 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 を試しました。

js
const res = await fetch('http://api.example.com:8081/items', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'りんご' }),
});

同じ API に対して、コンソールには次のように出ました。

text
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行だけでした。

text
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 を返します。

js
// 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 は、まだ次のメッセージで止まりました。

text
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 は届いていませんでした。

プリフライトにも答えるようにすると、エラーが消える

最後に、プリフライトの応答に、使ってよいメソッドとヘッダーを足しました。

js
// 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 の前にプリフライトが届いています。

text
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 を送ると、次の応答が返りました。

console
$ 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 を、次のように呼んでみました。

js
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()}"`;

コンソールにエラーは出ませんでしたが、画面の表示は次のとおりで、中身は空でした。

text
type: opaque, status: 0, body: ""

MDN の CORS エラーのページにあるとおり、no-cors の応答は中身を読めない opaque な応答になり、ステータスは 0、ヘッダーは空、本文は JavaScript から読めません。アクセス解析のビーコンのように、送るだけで応答を使わないときのためのものです。

ポイント

API の応答を画面で使いたいなら、直すのはサーバーの側です。自分で API に手を入れられないときは、MDN のページで、自分で管理するサーバーを間に置き、そこから API を呼んで、CORS のヘッダーを付けて返す方法が紹介されています。

​Posted by 86