Go言語 panic: assignment to entry in nil map の原因と解決方法【マップ初期化の落とし穴と実践的な対処法】

panic: assignment to entry in nil map とは

Go言語でマップ（map）を使っていると、突然「panic: assignment to entry in nil map」というエラーに遭遇し、プログラムが強制終了してしまった経験はありませんか？ このエラーは、Go言語のマップの特性を理解していないと陥りやすい典型的な落とし穴の一つです。特に、マップを宣言しただけで初期化を忘れてしまうと発生します。

エラーの発生パターン

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

パターン1: nilマップへの直接代入

package main

import "fmt"

func main() {
    var m map[string]int // マップを宣言したが、初期化していない
    // m = make(map[string]int) // これがないとエラー

    m["key"] = 10 // panic: assignment to entry in nil map
    fmt.Println(m["key"])
}

Go言語において、`var m map[string]int` のようにマップを宣言しただけでは、そのマップはnilです。nilマップは要素を保持するためのメモリが割り当てられていないため、直接要素を代入しようとすると `panic: assignment to entry in nil map` エラーが発生します。マップを使う前に、`make`関数で明示的に初期化する必要があります。

package main

import "fmt"

func main() {
    var m map[string]int
    m = make(map[string]int) // make関数でマップを初期化

    m["key"] = 10
    fmt.Println(m["key"]) // 出力: 10
}

パターン2: 関数引数で渡されたnilマップへの操作

package main

import "fmt"

func addValue(data map[string]int, key string, value int) {
    data[key] = value // dataがnilマップの場合、ここでpanic
}

func main() {
    var myMap map[string]int // nilマップのまま
    addValue(myMap, "age", 30) // panic: assignment to entry in nil map
    fmt.Println(myMap)
}

関数に引数としてマップを渡す際、呼び出し元でマップが初期化されていないと、関数内でそのマップに要素を代入しようとしたときにこのエラーが発生します。関数内でマップを操作する際は、引数として渡されたマップがnilでないことを確認するか、関数内で初期化を強制する必要があります。

package main

import "fmt"

// マップを初期化して返す、または引数で初期化済みマップを受け取る
func addValue(data map[string]int, key string, value int) map[string]int {
    if data == nil {
        data = make(map[string]int) // nilの場合、関数内で初期化
    }
    data[key] = value
    return data // 変更されたマップを返す（ポインタではないため）
}

func main() {
    var myMap map[string]int
    myMap = addValue(myMap, "age", 30) // 戻り値で受け取る
    fmt.Println(myMap["age"]) // 出力: 30
}

パターン3: 構造体内のマップフィールドの初期化忘れ

package main

import "fmt"

type User struct {
    ID      string
    Profile map[string]string // マップフィールド
}

func main() {
    user := User{ID: "user123"}
    user.Profile["name"] = "Alice" // panic: assignment to entry in nil map
    fmt.Println(user.Profile["name"])
}

構造体（struct）のフィールドとしてマップを定義した場合も同様に、構造体のインスタンスを作成しただけではマップフィールドはnilの状態です。そのマップフィールドにアクセスする前に、明示的に`make`関数で初期化する必要があります。

package main

import "fmt"

type User struct {
    ID      string
    Profile map[string]string
}

func main() {
    user := User{ID: "user123"}
    user.Profile = make(map[string]string) // 構造体フィールドのマップを初期化
    user.Profile["name"] = "Alice"
    user.Profile["email"] = "alice@example.com"
    fmt.Println(user.Profile["name"]) // 出力: Alice
}

根本原因の特定方法

スタックトレースを確認し、`panic: assignment to entry in nil map` が発生した{marker}ファイル名と行番号を特定{/marker}します。その行で操作されているマップ変数が、事前に`make`関数で初期化されているかを確認してください。特に、関数引数や構造体フィールドのマップで発生しやすいので、{marker}nilチェックを挟んで`fmt.Println`でマップの状態を出力{/marker}してみるのが有効です。

package main

import "fmt"

func main() {
    var m map[string]int

    fmt.Printf("Before assignment: m is nil? %t, m value: %v\n", m == nil, m) // nilチェックと値の出力

    // m = make(map[string]int) // コメントアウトを外すとエラー解消

    if m == nil {
        fmt.Println("Error: Map 'm' is nil. It needs to be initialized with make().")
        // ここで panic になる行をスキップするなどの対処も可能
        // m = make(map[string]int) // デバッグ中に初期化して動作確認
    }

    m["key"] = 10 // ここで panic が発生する可能性がある
    fmt.Println(m["key"])
}

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

Go言語でマップを使用する際は、{marker}必ず`make`関数で初期化{/marker}することを習慣にしましょう。マップを宣言と同時に初期化する方法（`m := make(map[string]int)`）や、リテラルを使って初期化する方法（`m := map[string]int{“key”: 10}`）が一般的です。構造体のフィールドとしてマップを持つ場合も、構造体のコンストラクタ関数などでマップの初期化を組み込むと良いでしょう。

package main

import "fmt"

// 構造体のコンストラクタでマップを初期化する例
type Config struct {
    Settings map[string]string
}

func NewConfig() *Config {
    return &Config{
        Settings: make(map[string]string), // マップを初期化
    }
}

func main() {
    // 宣言と同時に初期化
    m1 := make(map[string]int)
    m1["age"] = 30
    fmt.Println("m1:", m1)

    // リテラルで初期化
    m2 := map[string]string{"name": "Alice", "city": "Tokyo"}
    m2["country"] = "Japan"
    fmt.Println("m2:", m2)

    // コンストラクタを使って構造体内のマップを初期化
    cfg := NewConfig()
    cfg.Settings["timeout"] = "30s"
    fmt.Println("cfg.Settings:", cfg.Settings)
}

よくある質問（FAQ）

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