CORSエラーの体験

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

1. APIサーバの準備

1.1 プロジェクトの作成

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

cors-hands-on/         ← このフォルダを作成
└── api-server/        ← このフォルダを作成

cors-hands-on フォルダで、以下のコマンドを実行してGoがインストールされていることを確認します。

go version

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

go version go1.x.x darwin/arm64

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

api-serverフォルダに移動し、モジュールを初期化します。

cd api-server
go mod init api-server

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

go: creating new go.mod: module api-server

続いて、APIサーバでGinを使うため、Gin本体をgo getコマンドで取得します。

go get github.com/gin-gonic/gin

以下のような実行結果が表示されます(バージョンは環境により変わります)。

go: added github.com/gin-gonic/gin v1.10.0

1.2 main.go の作成

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

cors-hands-on/
└── api-server/
    ├── go.mod
    ├── go.sum
    └── main.go       ← このファイルを作成

本章はCORSの動作に集中するため、データベースは使わず、コード内に固定データを持たせる形にします。作成したファイルに以下の内容を記述して保存します。これは、GET /notesでノートの固定データをJSONで返し、PUT /notes/:idで仮の更新レスポンスを返す、最小構成のAPIサーバです。PUTは後半でプリフライトリクエストを確認するときに使います。

package main

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

type Note struct {
	ID    int    `json:"id"`
	Title string `json:"title"`
}

func main() {
	r := gin.Default()

	r.GET("/notes", func(c *gin.Context) {
		notes := []Note{
			{ID: 1, Title: "買い物"},
			{ID: 2, Title: "打ち合わせ資料"},
		}
		c.JSON(http.StatusOK, notes)
	})

	r.PUT("/notes/:id", func(c *gin.Context) {
		id := c.Param("id")
		c.JSON(http.StatusOK, gin.H{"id": id, "status": "updated"})
	})

	r.Run(":8080")
}

1.3 動作確認

動作を確認するため、以下のコマンドでAPIサーバを起動します。

go run main.go

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

[GIN-debug] Listening and serving HTTP on :8080

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

curl http://localhost:8080/notes

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

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

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

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

APIをブラウザから呼び出すには、画面を配信するサーバも別に必要です。ここでは、静的なHTMLファイルを配信するだけのGoサーバをfrontendフォルダに用意します。

2.1 プロジェクトの作成

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

cors-hands-on/
├── api-server/     ← 起動中のまま
└── frontend/       ← このフォルダを作成

Visual Studio Codeで新しいターミナルを追加し(APIサーバが動いているターミナルは残したまま)、frontendフォルダに移動してからモジュールを初期化します。

cd frontend
go mod init frontend

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

go: creating new go.mod: module frontend

2.2 配信サーバとHTMLの作成

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

cors-hands-on/
├── api-server/
│   ├── go.mod
│   ├── go.sum
│   └── main.go
└── frontend/
    ├── go.mod
    └── main.go     ← このファイルを作成

作成したmain.goに以下の内容を記述して保存します。これは、publicフォルダ以下の静的ファイルをhttp://localhost:5173/で配信するだけのサーバです。

package main

import (
	"log"
	"net/http"
)

func main() {
	fs := http.FileServer(http.Dir("./public"))
	log.Println("frontend: http://localhost:5173")
	log.Fatal(http.ListenAndServe(":5173", fs))
}

続いて、配信するHTMLを置くpublicフォルダを作成し、その中にindex.htmlを作成します。

cors-hands-on/
├── api-server/
│   └── ...
└── frontend/
    ├── go.mod
    ├── main.go
    └── public/         ← このフォルダを作成
        └── index.html  ← このファイルを作成

index.htmlに以下の内容を記述して保存します。これは、http://localhost:8080/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:8080/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>

2.3 動作確認

ブラウザからアクセスできる画面を用意するため、新しく開いたターミナルで、以下のコマンドでフロントエンド用サーバを起動します。

go run main.go

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

frontend: http://localhost:5173

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

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

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

画面に表示された「取得に失敗: Failed to fetch」のエラー

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

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

開発者ツールのConsoleタブに表示されたCORSエラー

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