メモリ

Go言語で新しいUUIDを生成する方法を解説

2025-02-20更新日: 2025-02-20

Go言語でUUID(Universally Unique Identifier)を生成する方法を解説します。

各種サービスやシステムで使われる識別子として、UUIDは重複を避けるために役立ちます。

すでに実行環境が整っている方向けに、シンプルな生成方法とコード例を交えて紹介します。

目次から探す

ライブラリ選定と概要
- 主なUUID生成ライブラリの紹介
ライブラリのインストールとセットアップ
- インストール手順
- インポートと基本設定
コードによるUUID生成の実装
- シンプルなUUID生成例
- エラーハンドリングの実装
UUID活用シーンの例
- APIレスポンスでの利用方法
- データベースとの連携
まとめ

ライブラリ選定と概要

主なUUID生成ライブラリの紹介

github.com/google/uuid の特徴

github.com/google/uuid は、Go言語でUUIDを生成する際に定番といえるライブラリです。

このライブラリは外部依存が少なく、シンプルなAPIでUUIDを簡単に生成できる点が特徴です。

内部でランダムな数値生成を行い、一意性を保ちながら短いコードでUUIDを生成することができます。

また、標準ライブラリと同じ感覚で利用できるため、導入がスムーズです。

他ライブラリとの比較

その他にも satori/go.uuid や gofrs/uuid などのライブラリが存在します。

satori/go.uuid は以前から使われているライブラリですが、メンテナンスの面で不安要素がある場合もあります。
gofrs/uuid は安定性とパフォーマンス面で評価され、プロダクションでの利用例も多いです。

一方で、github.com/google/uuid は簡潔で理解しやすいAPIを提供しており、開発環境構築済みの環境であればスムーズに導入できる点が魅力です。

ライブラリのインストールとセットアップ

インストール手順

go get コマンドの使用例

UUID生成ライブラリを利用するためには、以下のように go get を使用してインストールします。

次のコマンドをターミナル上で実行してください。

go get github.com/google/uuid

このコマンドを利用することで、依存パッケージが自動的に取得され、環境に組み込まれます。

モジュール管理の確認

Go Modules を利用している場合、プロジェクトのルートにある go.mod ファイルに以下のようにライブラリの依存関係が追加されます。

プロジェクトのルートディレクトリで go mod tidy コマンドを実行し、不要な依存関係が削除され、必要なライブラリが正しく管理されているか確認してください。

インポートと基本設定

必要なパッケージのインポート方法

UUIDを生成するために、ソースコード内で以下のようにパッケージをインポートします。

例えば、main.go 内でUUIDを生成する場合は次のように設定してください。

package main
import (
	"fmt"
	"github.com/google/uuid" // UUID生成用パッケージ
)
func main() {
	// newUUID に新しいUUIDを生成
	newUUID := uuid.New()
	fmt.Printf("Generated UUID: %s\n", newUUID.String())
}

このコードは、github.com/google/uuid のインポートと main関数内での UUID 生成の基本例です。

コードによるUUID生成の実装

シンプルなUUID生成例

コードサンプルの説明

以下のサンプルコードは、シンプルなUUID生成の例です。

main関数内で新しいUUIDを生成し、標準出力に出力します。

コード内のコメントで各処理の役割について説明しています。

package main
import (
	"fmt"
	"github.com/google/uuid" // UUID関連の処理を提供するパッケージ
)
func main() {
	// uuid.New() を利用して新しいUUIDを生成
	newUUID := uuid.New()
	// 結果を文字列形式に変換して出力
	fmt.Printf("Generated UUID: %s\n", newUUID.String())
}

出力結果の確認

上記サンプルコードを実行した場合の出力結果例は以下の通りです。

Generated UUID: 3fa85f64-5717-4562-b3fc-2c963f66afa6

エラーハンドリングの実装

エラー発生時の対処法

通常、uuid.New() はエラーを返さないためエラーハンドリングは不要です。

しかし、UUIDの解析や他の操作の場合、エラーが発生する可能性があります。

例えば、文字列からUUIDに変換する際は、uuid.Parse() を利用し、エラー処理を行います。

package main
import (
	"fmt"
	"github.com/google/uuid"
)
func main() {
	// サンプルのUUID文字列
	uuidStr := "invalid-uuid-string"
	// uuid.Parse() を利用して文字列をUUIDに変換
	parsedUUID, err := uuid.Parse(uuidStr)
	if err != nil {
		// エラーが発生した場合の対処
		fmt.Printf("Error: %v\n", err)
		return
	}
	fmt.Printf("Parsed UUID: %s\n", parsedUUID.String())
}

チェックポイントの解説

上記のコードでは、以下のチェックポイントが含まれています。

uuid.Parse() の呼び出し時にエラーを返す可能性があるため、その返り値 err を検証します。
エラーが存在する場合は、エラーメッセージを出力しプログラムの実行を終了する構成です。

これにより、想定外の入力によってプログラムがクラッシュするのを未然に防ぐことができます。

UUID活用シーンの例

APIレスポンスでの利用方法

リクエスト毎のUUID生成例

APIのエンドポイントごとに一意な識別子を付与するために、各リクエスト時にUUIDを生成する例です。

以下のサンプルコードはWebサーバーでの利用例として、リクエストごとにUUIDを作成し、JSON形式のレスポンスに含める構成になっています。

package main
import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"github.com/google/uuid" // UUID生成に利用
)
func handler(w http.ResponseWriter, r *http.Request) {
	// 新しいUUIDを生成し、レスポンス構造体に格納
	response := struct {
		RequestID string `json:"request_id"`
		Message   string `json:"message"`
	}{
		RequestID: uuid.New().String(), // リクエスト毎に一意なUUIDを生成
		Message:   "リクエストを正常に処理しました",
	}
	// JSON形式でレスポンスを返す
	w.Header().Set("Content-Type", "application/json")
	json.NewEncoder(w).Encode(response)
}
func main() {
	http.HandleFunc("/", handler)
	fmt.Println("サーバーがポート8080で開始されました")
	log.Fatal(http.ListenAndServe(":8080", nil))
}

このコードはブラウザやAPIクライアントでアクセスするたびに、リクエスト毎のUUIDを生成し、JSONレスポンスに含める仕組みです。

データベースとの連携

一意な識別子としての活用方法

データベースのエントリに一意な識別子を割り当てるためにUUIDを利用するケースです。

以下は、データ登録前にUUIDを生成し、構造体のフィールドとして利用する例です。

package main
import (
	"fmt"
	"github.com/google/uuid" // UUID生成用のパッケージ
)
// User 構造体はユーザ情報と一意な識別子を保持する例です
type User struct {
	ID   string // 一意な識別子としてUUIDを利用
	Name string
}
func main() {
	// 新しいUUIDを生成して、User構造体のIDフィールドに設定
	newUser := User{
		ID:   uuid.New().String(),
		Name: "佐藤 太郎",
	}
	// 登録処理の前に一意性が保証されたIDを確認
	fmt.Printf("登録ユーザ: %+v\n", newUser)
}