Go言語で発生するエラーハンドリング忘れ（unhandled error）の原因と解決方法【パニックを防ぐ実践的な対処法】

panic: runtime error: … とは

Go言語では、関数がエラーを返すのが一般的です。しかし、そのエラーを適切に処理せず無視してしまうと、予期せぬランタイムパニックを引き起こし、アプリケーションが停止してしまうことがあります。このページでは、Go言語で頻繁に遭遇するエラーハンドリング忘れによる問題とその解決策を解説します。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: ファイル操作でのエラー無視

package main

import (
    "fmt"
    "os"
)

func main() {
    // 存在しないファイルをオープンしようとする
    file, _ := os.Open("non_existent_file.txt") // エラーを無視
    defer file.Close() // fileがnilの場合、ここでパニック

    data := make([]byte, 100)
    _, _ = file.Read(data) // fileがnilの場合、ここでパニック
    fmt.Println("File content:", string(data))
}

`os.Open` はファイルを開けなかった場合にエラーを返しますが、このコードでは {marker}`_` でエラーを破棄しています。`file` 変数には {marker}`nil` が代入され、その後の `file.Close()` や `file.Read()` で {marker}`nilポインタデリファレンス`が発生し、パニックとなります。

package main

import (
    "fmt"
    "os"
)

func main() {
    file, err := os.Open("non_existent_file.txt")
    if err != nil {
        // エラーを適切に処理
        fmt.Println("Error opening file:", err)
        return // 処理を中断
    }
    defer file.Close()

    data := make([]byte, 100)
    n, err := file.Read(data)
    if err != nil {
        fmt.Println("Error reading file:", err)
        return
    }
    fmt.Println("File content:", string(data[:n]))
}

パターン2: 型アサーションでのエラー無視

package main

import "fmt"

func main() {
    var i interface{} = "hello" // string型
    
    // iをint型にアサートしようとするが、実際はstring
    j := i.(int) // エラーを無視（実際にはpanic）
    fmt.Println(j)
}

インターフェース値の型アサーション `i.(T)` は、型が一致しない場合に {marker}`ランタイムパニック`を引き起こします。このコードでは `i` が `string` 型であるにも関わらず `int` 型としてアサートしようとするため、パニックが発生します。

package main

import "fmt"

func main() {
    var i interface{} = "hello"

    // 型アサーションが成功したかどうかをチェックする
    j, ok := i.(int)
    if !ok {
        fmt.Println("Type assertion failed: i is not an int")
        return // 処理を中断
    }
    fmt.Println(j)
}

パターン3: データベース操作でのエラー無視

package main

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql" // 仮のドライバ
)

func main() {
    // 誤ったDSNでデータベース接続を試みる
    db, _ := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/non_existent_db") // エラーを無視
    defer db.Close() // dbがnilでないが、接続自体はエラー状態

    // 接続エラーをチェックしないままQueryを実行
    rows, _ := db.Query("SELECT 1") // dbがエラー状態だと、ここでパニック（またはエラーが返されるが無視）
    defer rows.Close()
    for rows.Next() {
        var val int
        _ = rows.Scan(&val) // エラーを無視
        fmt.Println(val)
    }
}

`sql.Open` はドライバーの初期化エラー（DSNが不正など）を返すことがありますが、この例ではそれを無視しています。`db` オブジェクト自体は {marker}`nil` ではありませんが、内部的にはエラー状態です。その後 `db.Query` を実行すると、接続エラーにより {marker}`panic` が発生するか、エラーが返されるものの無視されるため、意図しない挙動となります。`rows.Scan` のエラーも無視すると、データ型不一致などで予期せぬ値が代入される可能性があります。

package main

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/non_existent_db")
    if err != nil {
        fmt.Println("Error opening database:", err)
        return
    }
    defer db.Close()

    // Pingで実際の接続を確認する
    err = db.Ping()
    if err != nil {
        fmt.Println("Error connecting to database:", err)
        return
    }

    rows, err := db.Query("SELECT 1")
    if err != nil {
        fmt.Println("Error querying database:", err)
        return
    }
    defer rows.Close()

    for rows.Next() {
        var val int
        err = rows.Scan(&val)
        if err != nil {
            fmt.Println("Error scanning row:", err)
            return
        }
        fmt.Println(val)
    }
}

根本原因の特定方法

Go言語でエラーハンドリング忘れによるパニックが発生した場合、スタックトレースを読み解くのが最も効果的なデバッグ方法です。パニックメッセージの後に続くスタックトレースは、どのファイル、どの行で何が原因でパニックが発生したかを示しています。特に{marker}`自身のコードファイル`に記載されている行を重点的に確認し、その箇所で返される可能性のあるエラーが適切に処理されているか、またはnilチェックがされているかを確認しましょう。

package main

import (
	"fmt"
	"os"
)

func main() {
	// この行でパニックが発生した場合、スタックトレースが指し示す場所を特定
	file, err := os.Open("non_existent_file.txt")
	if err != nil {
		fmt.Println("DEBUG: Failed to open file, error:", err) // デバッグログを追加
		// ここで return することで、nilポインタデリファレンスを防ぎ、
		// どこでエラーが発生したかを明確にする
		return
	}
	defer file.Close()

	// ここに到達しないことを確認
	fmt.Println("DEBUG: File opened successfully.")
}

防止策とベストプラクティス

Go言語でエラーハンドリング忘れを防ぐには、以下のプラクティスを徹底することが重要です。
1. **全ての `error` 戻り値をチェックする**: 関数が `(value, error)` の形式で戻り値を返す場合、必ず `if err != nil` でエラーの有無をチェックし、適切な処理を行います。
2. **静的解析ツールを活用する**: `go vet` や `staticcheck` などの静的解析ツールは、未処理のエラーの可能性を警告してくれることがあります。CI/CDパイプラインに組み込むことで、早期に問題を検出できます。
3. **テスト駆動開発（TDD）**: エラーケースを含むユニットテストを事前に書くことで、エラー処理の漏れをなくすことができます。

package main

import (
	"fmt"
	"os"
)

// 安全にファイルをオープンするヘルパー関数
func safeOpenFile(filename string) (*os.File, error) {
	file, err := os.Open(filename)
	if err != nil {
		// エラーをラップして、呼び出し元に詳細な情報を提供する
		return nil, fmt.Errorf("failed to open file %s: %w", filename, err)
	}
	return file, nil
}

func main() {
	file, err := safeOpenFile("non_existent_file.txt")
	if err != nil {
		// ヘルパー関数からのエラーを適切に処理
		fmt.Println("Application error:", err)
		return
	}
	defer file.Close()
	fmt.Println("File processed.")
}

よくある質問（FAQ）

この用語と一緒に知っておきたい用語

このエラーと一緒にしっておきたいエラー