CORSエラーの体験

まずは、APIサーバとフロントエンド用サーバを立ち上げ、ブラウザから画面越しにAPIを呼び出したときにCORSエラーが発生することを確認します。ここで実際にエラーの挙動を見ておくと、後続の対策の必要性が具体的に理解できます。

1. APIサーバの準備

任意の場所にcors-hands-onフォルダを作成し、Visual Studio Codeの「ファイル」→「フォルダーを開く」からcors-hands-onフォルダを開いてください。以降の操作は、Visual Studio Codeのターミナルから行います。

cors-hands-on/  ← このフォルダを作成

以下のコマンドで、Pythonがインストールされていることを確認します。

Windowsの場合:

python --version

Macの場合:

python3 --version

以下のようにPythonのバージョンが表示されれば、インストールは確認できています。

Python 3.12.x

バージョンが表示されない場合は、Pythonのインストールを先に実施してください。

続いて、FastAPIとuvicornをインストールします。

Windowsの場合:

pip install fastapi uvicorn

Macの場合:

pip3 install fastapi uvicorn

Visual Studio Codeのエクスプローラーでcors-hands-onフォルダを右クリックし、「新しいファイル」を選択してmain.pyを作成します。

cors-hands-on/
└── main.py       ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。これは、GET /notesでノートの固定データをJSONで返し、PUT /notes/{note_id}で仮の更新レスポンスを返す、最小構成のFastAPIサーバです。PUTは後半でプリフライトリクエストを確認するときに使います。

from fastapi import FastAPI

app = FastAPI()

@app.get("/notes")
def list_notes():
    return [
        {"id": 1, "title": "買い物"},
        {"id": 2, "title": "打ち合わせ資料"},
    ]

@app.put("/notes/{note_id}")
def update_note(note_id: int):
    return {"id": note_id, "status": "updated"}

以下のコマンドでAPIサーバを起動します。

uvicorn main:app --reload

以下のような実行結果が表示されます。

INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

ポート8000でAPIサーバがリクエスト待ちの状態になりました。動作確認のために、別のターミナルからcurlで叩きます。

curl http://localhost:8000/notes

以下のような実行結果が表示されます。

[{"id":1,"title":"買い物"},{"id":2,"title":"打ち合わせ資料"}]

APIサーバはこのまま起動したままにしておきます。次はフロントエンド側を準備します。

2. フロントエンド用サーバの準備

APIをブラウザから呼び出すには、画面を配信するサーバも別に必要です。ここでは、Python標準のhttp.serverモジュールで静的HTMLを配信するだけの構成を用意します。

Visual Studio Codeのエクスプローラーでcors-hands-onフォルダを右クリックし、「新しいフォルダー」を選択してfrontendという名前でフォルダを作成します。続けて、frontendフォルダの中にindex.htmlを作成します。

cors-hands-on/
├── main.py
└── frontend/         ← このフォルダを作成
    └── index.html    ← このファイルを作成

index.htmlに以下の内容を記述して保存します。これは、http://localhost:8000/notesをfetchで呼び出し、結果を画面に表示する最小のHTMLです。本章の主眼はCORSの動作確認なので、HTML/JavaScriptの文法解説は省略します。フロントエンドのコード自体は フロントエンド講座 に記載があります。

<!DOCTYPE html>
<html lang="ja">
<head>
	<meta charset="UTF-8">
	<title>Notes</title>
</head>
<body>
	<h1>Notes</h1>
	<ul id="list"></ul>
	<script>
		fetch("http://localhost:8000/notes")
			.then((res) => res.json())
			.then((notes) => {
				const list = document.getElementById("list");
				for (const note of notes) {
					const li = document.createElement("li");
					li.textContent = `${note.id}: ${note.title}`;
					list.appendChild(li);
				}
			})
			.catch((err) => {
				document.getElementById("list").textContent = "取得に失敗: " + err.message;
			});
	</script>
</body>
</html>

Visual Studio Codeで新しいターミナルを追加し(APIサーバが動いているターミナルは残したまま)、frontendフォルダに移動してから静的ファイルサーバを起動します。

cd frontend

Windowsの場合:

python -m http.server 5173

Macの場合:

python3 -m http.server 5173

以下のような実行結果が表示されます。

Serving HTTP on :: port 5173 (http://[::]:5173/) ...

ポート5173でフロントエンド用サーバが起動しました。APIサーバ(:8000)とフロントエンド用サーバ(:5173)の両方が起動している状態になっています。

3. ブラウザからの呼び出しでのエラー確認

準備が整ったので、Webブラウザでhttp://localhost:5173/を開きます。画面にはNotesの見出しの下に「取得に失敗: Failed to fetch」と表示されます。

続いて、ブラウザの開発者ツールを開きます。Google Chromeであれば、右クリック→「検証」を選ぶか、F12キーで開きます。「Console」タブを見ると、以下のようなエラーが表示されています。

Access to fetch at 'http://localhost:8000/notes' from origin 'http://localhost:5173' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

APIサーバ自体はcurlで叩けば200 OKでノートを返せる状態ですが、ブラウザはhttp://localhost:5173のページからhttp://localhost:8000へのリクエストを、オリジンが異なると判断してレスポンスの受け取りをブロックしました。次の見出しで、この挙動の背景にあるCORSの仕組みを整理します。