Go程序跑着跑着进程就没了,日志第一行是panic: runtime error: invalid memory address or nil pointer dereference,紧跟一行[signal SIGSEGV: segmentation violation code=0x1 addr=0x0 pc=0x4a1b2c]。意思很直白:代码通过一个值为nil的指针去读写内存,或者用了一个落在零地址附近的野指针。这类退出码是2,不是被系统kill掉的137,别往OOM上查。
这个坑踩过不止一次。
先把堆栈读明白
panic打印的是当前goroutine的栈,默认只打这一个,格式是goroutine 1 [running]:打头,往下每一行一帧,最上面那帧就是崩的位置。帧里带包名、函数名、源文件路径和行号,行号后面常跟一个+0x2a形式的偏移。自研代码里最靠上的那一帧就是要看的地方,runtime和第三方包里面的帧只是路过。栈尾如果还有created by main.main in goroutine 1这样的行,说明崩在子goroutine里,那行给的是谁把它启动起来的。
panic: runtime error: invalid memory address or nil pointer dereference [signal SIGSEGV: segmentation violation code=0x1 addr=0x0 pc=0x4a1b2c] goroutine 1 [running]: main.loadConfig(...) /srv/app/config.go:47 +0x2a main.main() /srv/app/main.go:12 +0x18
addr那一项值得单独看。addr=0x0或者0x8、0x10这种很小的地址,基本就是nil指针加了个字段偏移;addr是个挺大的十六进制值,比如0xc000112000之类,多半是对象已经没了还留着旧指针,或者unsafe、cgo转换出来的野指针。code=0x1对应读或者写,SEGV_MAPERR和SEGV_ACCERR在更详细的signal行里还能再分,但定位到哪一帧之后这些已经不太影响结论。
几类最常见的来源
1、函数返回两个值,第二个是error,代码没判error直接用了第一个。os.Open、sql.Query、json.Unmarshal这类都是这个形状,出错时返回的指针就是nil,紧接着f.Close()或者对结果取字段就炸。实测过一批线上panic,这一类能占一半以上。
2、map取值只接了一个变量。m["k"]在key不存在时返回该类型的零值,指针、切片、map、接口、函数、通道的零值都是nil,后面再接.Field或者.Method()就崩。稳妥写法是接两个值:v, ok := m["k"],先判ok再往下用。
3、结构体指针字段没初始化。配置解析完,conf.DB是nil,代码直接conf.DB.SetMaxOpenConns(10),这一行就是案发现场。json.Unmarshal对嵌套指针字段,JSON里没出现该字段时不会帮着分配内存,字段保持nil。
4、接口里装了一个带类型的nil。这是Go里最绕的一类:var p *T = nil,把p赋给一个error或者interface{}之后,判空会得到不等于nil,因为接口内部记的是(类型,值)一对,类型那一格不是空的。之前接手过一个自定义错误类型就栽在这儿,函数里return的是nil指针,外层判err非空一路打日志,进到方法里才崩。
5、方法接收者本身是nil。指针方法可以允许nil接收者调用,只要方法体里不去碰字段,很多标准库类型都在方法开头判一下receiver再干活。自己写的方法没做这一步,外面又恰好传了个nil进来,一进方法就炸。
6、nil的map、切片、通道、函数各自行为不一样,容易张冠李戴。读一个nil的map没问题,返回零值;往nil的map里写会报assignment to entry in nil map,那是另一个panic串;nil切片可以append,len和cap都是0;往nil通道发数据会永久阻塞,close一个nil通道报close of nil channel;调用nil函数值报的也是invalid memory address。这几条分清楚,排查时少走弯路。
7、recover不是万能的。它只在同一个goroutine里、panic发生之前就注册好的defer中生效,子goroutine里冒出来的panic没人接,直接带走整个进程。更要紧的是runtime主动throw出来的fatal error不走panic流程,fatal error: all goroutines are asleep - deadlock和concurrent map writes这两类,recover一个都拦不住。
把行号和变量抓准
光看默认那份栈有时候不够。编译器内联会把某一层函数吃掉,行号落到调用方,看着对不上源码。用go build -gcflags="all=-N -l"关掉内联和优化再复现一遍,帧就和源码一一对上了。想看别的goroutine当时在干什么,把GOTRACEBACK设成all或者system:默认single只打当前这一个,all补上所有用户创建的goroutine,system再加runtime的栈帧和内部goroutine,crash在system的基础上让进程按系统方式崩溃,Unix上会触发SIGABRT顺便出core。Windows上对应的是wer档,行为像crash但保留WER上报。历史别名0、1、2分别等于none、all、system,别记反。
runtime/debug.SetTraceback可以在程序里调,但只能往上加不能往下减,环境变量设成system之后再想用代码调回single是做不到的。核心转储那条路是ulimit -c放开限制,配GOTRACEBACK=crash让进程真正崩,拿到core之后用dlv core ./app core挂进去,bt看栈、frame切帧、locals和print看变量当时的值。静态检查这边staticcheck的SA5011能报出一部分明显的空指针解引用,但查不全,别把它当保险。
还有个容易忽略的地方:panic的输出走stderr,也就是文件描述符2。容器或者托管平台把stdout和stderr分开采集时,只在应用日志里翻是找不到这串的,得到标准错误那一路去看。Go 1.20、1.21、1.22、1.23、1.24、1.25、1.26,这套panic格式一直没变;从Go 1.21起panic(nil)不再打出nil,而是返回一个*runtime.PanicNilError,遇到老代码依赖旧行为的,用GODEBUG=panicnil=1能临时退回去。数据截至2026年11月。
go build -gcflags="all=-N -l" -o app . GOTRACEBACK=all ./app GOTRACEBACK=crash ./app # 配合ulimit-c-unlimited出core ulimit -c unlimited dlv core ./app core staticcheck ./...
收尾就一句:先把日志里addr那一项和栈首那个文件行号抄下来,再决定是补判空还是改初始化顺序。别一上来就加recover,把panic吞掉之后问题只会换个地方冒出来。