如何追踪Go语言中「runtime error: invalid memory address or nil pointer dereference」错误？

1. 利用panic自带的堆栈信息 #

空指针引用触发的runtime error: invalid memory address or nil pointer dereference本质是runtime panic，Go默认会输出完整的调用堆栈，包含第三方库的调用路径。如果你的程序没输出堆栈，检查是否存在recover()未打印堆栈的情况——可以在主入口或关键代码块添加以下代码强制捕获并打印堆栈：

import "runtime/debug"

func main() {
    defer func() {
        if r := recover(); r != nil {
            println("panic occurred:", r)
            println(string(debug.Stack()))
        }
    }()
    // 你的业务代码
}

2. 使用Delve调试器精准定位 #

Delve是Go生态的官方调试工具，功能和其他语言的调试器（比如GDB、LLDB）类似，能直接定位到错误发生的代码行：

• 安装Delve：go install github.com/go-delve/delve/cmd/dlv@latest
• 启动调试会话：dlv debug ./your-main-module（替换为你的主包路径）
• 设置panic断点：在调试控制台输入break runtime.fatalpanic，然后执行continue，程序触发错误时会自动暂停
• 查看调用链：输入bt即可打印完整堆栈，第三方库的调用细节会清晰显示

也可以直接带参数启动调试：dlv debug ./your-module -- your-program-args，程序出错时自动暂停，直接查看堆栈即可。

3. 确保编译保留调试信息 #

如果之前编译时加了-ldflags="-s -w"参数（用于精简二进制），会剥离调试符号，导致调试器无法解析代码行。去掉该参数重新编译，保证调试器能获取完整的符号表信息。

关于log.SetFlags无效的说明 #

log.SetFlags(log.LstdFlags|log.Llongfile)仅对全局log包的默认Logger生效，如果第三方库是自行创建log.Logger实例，这个全局设置不会影响它们的日志输出。相比修改第三方库日志配置，直接依赖panic堆栈或调试器是更高效的定位方式。

内容的提问来源于stack exchange，提问作者wxh