空指针解引用触发的panic堆栈第一行指向出问题代码，第二行文件名和行号绝对可靠；常见于结构体指针方法调用、json解包、数据库查询及模板渲染中未判空的指针。
Go里空指针解引用触发的 panic: runtime error: invalid memory address or nil pointer dereference，堆栈第一行就指向出问题的那行代码——前提是堆栈没被裁剪或重定向。关键不是猜哪错了，而是确保这行信息能被你看到。
看懂 panic 堆栈最上面那一行
典型输出长这样：
panic: runtime error: invalid memory address or nil pointer dereference goroutine 1 [running]: main.(*User).Greet(...) /path/to/main.go:10 main.main() /path/to/main.go:15
重点盯住第二行：它明确告诉你 panic 发生在 main.go 第 10 行，函数是 (*User).Greet。这个行号绝对可靠，不用怀疑。
- 如果堆栈里没有你的文件名（比如只看到
runtime/...或encoding/json/...），说明 panic 被第三方库吞掉了一层上下文——得往前加defer捕获 - 如果行号指向的是
c.Next()或handler.ServeHTTP()这类框架入口，说明 panic 在中间件或 handler 内部，但堆栈被 Go 的 defer 链裁剪了 - 别信
+0x5b这种偏移量，日常排查直接忽略
在 handler 顶层加 defer recover 打印完整堆栈
Gin 等框架默认 Recovery 中间件会吃掉 panic，且不输出堆栈到终端。你得自己在 handler 入口补一层防御：
func MyHandler(c *gin.Context) {
defer func() {
if r := recover(); r != nil {
log.Printf("[HANDLER PANIC] %s %s: %v", c.Request.Method, c.FullPath(), r)
debug.PrintStack()
}
}()
// 正常业务逻辑...
}
- 这个
defer必须放在 handler 函数最开头，否则可能漏掉 panic -
debug.PrintStack()比debug.Stack()更直接，不用转string，也不用担心日志格式错乱 - 如果用了
gin.DefaultWriter = io.Discard，记得把debug.PrintStack()改成fmt.Fprint(os.Stderr, debug.Stack())
nil 指针常见藏身点和检查习惯
空指针不是随机出现的，集中在几个高频位置：
- 调用结构体指针方法前没判空：
if u == nil { return } u.DoSomething() - 解包 JSON 到 nil 结构体指针：
var user *User; json.Unmarshal(body, &user)→user仍为nil，后续访问字段就崩 - 数据库查询返回
nilstruct：var u User; db.First(&u, id)如果查不到，u字段全零值，但若误写成db.First(&u, id).Error且u是nil地址，就会 panic - 模板渲染时访问嵌套字段：
{{.Data.User.Name}}，只要Data或User任一为nil，模板引擎就 panic
日常写代码时，对任何可能为 nil 的指针、接口、map、slice，在解引用前加一行 if x == nil { ... }，比事后 debug 快十倍。
为什么有时 debug.Stack() 比默认 panic 堆栈更管用
默认 panic 堆栈只显示当前 goroutine 的活跃帧；而 debug.Stack() 返回所有 goroutine 的快照，包含 created by 信息。当你怀疑是 goroutine 启动逻辑埋的雷（比如异步任务里用了已释放的指针），就得靠它。
-
debug.Stack()返回[]byte，必须显式转成string才能打印：log.Println(string(debug.Stack())) - 如果
recover所在函数被编译器内联，上层调用帧可能丢失；加//go:noinline注释可强制保留 - 生产环境慎用
debug.Stack()，它会采集全部 goroutine 状态，有性能开销
真正难定位的不是 panic 本身，而是那个“看起来不可能为 nil 却偏偏是 nil”的变量——它往往来自上游未校验的输入、未初始化的依赖、或并发竞争下的状态错乱。堆栈只是起点，不是终点。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
