初級

assignment to entry in nil map の原因と直し方

makeで初期化していないnilのマップに要素を書き込もうとすると、実行時にパニックが発生します。マップのゼロ値はnilで、読み取りはできても書き込みはできません。

エラーメッセージの読み方

panic: assignment to entry in nil map

panic

パニック — 実行時に回復不能な状態になったことを示します。deferとrecoverで捕まえない限り、そのままプロセスが終了します

assignment to entry in nil map

詳細メッセージ — どの値が問題だったか

このエラーが出る典型パターン

 1  package main
 2  
 3  func main() {
 4  	var m map[string]int     
                 ^
 5  	m["a"] = 1
 6  }

 1  package main
 2  
 3  func main() {
 4  	var m map[string]int     
                 ^
 5  	m["total"] = 100
 6  }

 1  package main
 2  
 3  func main() {
 4  	var m map[string]string     
                   ^
 5  	m["name"] = "go"
 6  }

 1  package main
 2  
 3  func main() {
 4  	var m map[int]string     
                 ^
 5  	m[1] = "one"
 6  }

 1  package main
 2  
 3  func main() {
 4  	var m map[string]bool     
                  ^
 5  	m["ok"] = true
 6  }

よくある誤解

「var で宣言した時点で、マップは空の状態で書き込み可能になっているはず」という思い込みは誤りです。マップのゼロ値はnilであり、make(map[K]V)で明示的に初期化しない限り要素を追加できません。

実務での勘所

nilマップは書き込みだけがパニックし、読み取りは安全です。nilのmap[string]intに対してm["key"]と読み取ると、パニックせずにその値の型のゼロ値(この場合は0)が返ってきます。書き込み(m["key"] = 1)だけがパニックの対象です。この非対称性のせいで、読み取りだけのテストでは「動いているように見える」状態のまま、実際に値を追加しようとした瞬間に初めてパニックが発覚することがあります。

演習をはじめる

関連するエラー

• invalid memory address or nil pointer dereference の原因と直し方値が代入されていないnilのポインタや構造体のフィールドにアクセスすると、実行時にパニックが発生します。
• slice bounds out of range の原因と直し方スライスをs[a:b]の形で切り出す際、範囲の終端が容量を超えているとパニックします。