Go error インターフェース

JPKODA 編集部 May 9, 2026

Go言語におけるエラーハンドリング（Error Handling）の設計思想は、JavaやPythonのような try-catch によるエクセプション（Exception）キャッチメカニズムとは本質的に異なります。Goではエラー（Error）を整数や文字列と同じように、単なる「値」として扱います。

組み込みの error タイプを理解し、熟練して使いこなすことは、堅牢で信頼性が高く、簡単にクラッシュしないGoプログラムを記述するための前提条件です。適切なエラーハンドリングは、プログラムが予期せぬ状況に優雅に対応できるようにするだけでなく、デバッグ（Debugging）やトラブルシューティングの際に極めて重要なコンテキスト（Context）情報を提供します。

1. errorインターフェースの正体

Goのソースコード（Source Code）において、error は実のところ極めてシンプルな組み込みのインターフェース（Built-in Interface）です：

type error interface {
    Error() string
}

このインターフェースの設計はミニマリズムの典型です：Error() メソッド（Method）を規定しているだけで、このメソッドはエラーを説明する文字列（string）を返します。

Error() string メソッドを実装（Implement）しているデータタイプ（Data Type）であれば、Go言語の視点からはすべて正当な error と見なされます。この柔軟な設計により、基礎的なテキストエラーだけでなく、エラーコードや発生時刻などの豊富なコンテキストを保持した複雑なカスタムエラータイプを定義することも可能になります。

1.1 ゼロ値：nilは「すべて正常」を意味する

ポインタ（Pointer）のゼロ値（Zero Value）が nil であるのと同様に、error インターフェースのゼロ値も nil です。

Goのイディオム（Idiom）では、ファンクション（Function）が正常に実行され、異常が発生しなかった場合、エラー値として nil を返さなければなりません。これにより、呼び出し側は「エラー値が nil かどうか」を判定するだけで、オペレーション（Operation）が成功したかを確認できます。

2. ファンクションからエラーを返す（標準的な作法）

以前のセクションで学んだ「マルチリターン（多重戻り値）」という特性により、Go言語のファンクションは通常、error を最後の戻り値として返します。これはコミュニティ全体で厳格に守られている黄金のルールです。

2.1 実践例：安全な割り算

エラーをスロー（Throw）するロジックを含む割り算ファンクションを見てみましょう：

package main

import (
	"errors" // 標準ライブラリの errors パッケージをインポート
	"fmt"
)

// divide は2つの浮点数を受け取り、商とエラー情報を返します
func divide(a, b float64) (float64, error) {
	if b == 0 {
		// errors.New() を使用して最も基本的なテキストエラーオブジェクトを作成
		return 0, errors.New("除数はゼロにできません") 
	}
	// 実行成功。計算結果を返し、エラーを nil に設定
	return a / b, nil 
}

func main() {
    // 呼び出し側のデモは次のセクションで解説
}

この例では：

もし b が 0 であれば、ファンクションはこの不正な操作をインターセプト（Intercept）し、デフォルト値 0 と、標準ライブラリの errors.New で構築したエラー説明を含むオブジェクトを返します。
操作が正当であれば、商を返し、nil を使って「エラーは発生しなかった」と明確に宣言します。

3. Go言語を支配する「if err != nil」

オープンソース（Open Source）のGoプロジェクトのソースコードを読めば、コード内が if err != nil で埋め尽くされていることに気づくでしょう。これはGoでエラーを処理する最も標準的で核心的なパターン（Pattern）です。

これは開発者に対して、エラーが発生する可能性のあるファンクションを呼び出すたびに、即座にその潜在的なエラーと向き合い処理することを強制します。try-catch のようにエラーをどこか遠くへ投げ飛ばして一括処理するのとは対照的です。

3.1 標準的なエラーハンドリングのテンプレート

package main

import (
	"errors"
	"fmt"
)

func divide(a, b float64) (float64, error) {
	if b == 0 {
		return 0, errors.New("除数はゼロにできません")
	}
	return a / b, nil
}

func main() {
    // 1. 呼び出しを実行し、同時に結果（Result）とエラー（Error）を受け取る
	result, err := divide(10, 2)
		
	// 2. 即座にエラーが発生したかチェック
	if err != nil {
	    // エラー処理ロジック（ログ出力、リトライ、またはプログラムの終了など）
		fmt.Println("エラーが発生しました:", err)
		return 
	}
		
	// 3. err が nil の場合のみ、安全に結果を使用
	fmt.Println("計算結果:", result)
}

4. 実戦演習：ファイルの読み込みとエラーラッピング

実際の業務では、下位レイヤーのファンクション呼び出しでエラーが発生した際、エラーを返す前に現在のレイヤーのコンテキスト情報を追加したい場面が頻繁にあります。

（注：元のチュートリアルでは ioutil.ReadFile が使用されていましたが、Go 1.16以降、そのパッケージは非推奨（Deprecated）となっています。よりモダンで推奨される方法は os.ReadFile を直接使用することです。ここでは最新の標準を採用します。）

package main

import (
	"fmt"
	"log"
	"os"
)

// readFile はファイルの読み込みを試行し、エラー発生時に元のエラーを「ラッピング」します
func readFile(filename string) ([]byte, error) {
	content, err := os.ReadFile(filename) // モダンなGoの推奨される使用法
	if err != nil {
		// fmt.Errorf と %w フォーマット指定子を使用して元のエラー err をラッピング (Wrap)
		// これにより、下位レイヤーのエラー原因を保持しつつ、独自のコンテキスト情報を追加できます
		return nil, fmt.Errorf("設定ファイル %s を読み込めません: %w", filename, err)
	}
	return content, nil
}

func main() {
	data, err := readFile("config.txt") // 存在しないファイルをわざと読み込みます
	if err != nil {
		// log.Fatalf はエラー情報を出力し、os.Exit(1) を呼び出してプログラムを強制終了します
		log.Fatalf("致命的なエラー: %s", err) 
		return
	}
		
	fmt.Printf("ファイル内容: %s\n", string(data))
}

この例における fmt.Errorf と %w (Wrap) の組み合わせは、非常に強力な機能です（Go 1.13で導入）。エラーを上位レイヤーに渡す際、マトリョーシカ人形のようにエラーを一層ずつ包み込むことができ、最終的なトラブルシューティングの際にエラーチェーン（Error Chain）全体を明確に把握することが可能になります。