Go中记录错误堆栈需用runtime.Caller获取单层调用信息、runtime.Stack打印完整调用栈,结合errors.WithStack封装错误或defer/recover捕获panic并输出全goroutine堆栈。

在 Golang 中记录错误堆栈并打印调用链,是排查问题的关键手段。Go 的标准库提供了 runtime 包来获取程序运行时的调用栈信息,结合 fmt 和 log 可以实现清晰的错误追踪。
使用 runtime.Caller 和 runtime.Callers 获取调用信息
Go 的 runtime.Caller(skip) 函数可以返回当前 goroutine 调用栈中第 skip 层的函数信息,包括文件名、行号和函数名。
示例代码:
func GetCallerInfo() string {_, file, line, ok := runtime.Caller(1) // skip=1 表示调用该函数的上一层
if !ok {
return "unknown"
}
return fmt.Sprintf("%s:%d", file, line)
}
这个函数可用于记录哪个文件哪一行触发了错误。
立即学习“go语言免费学习笔记(深入)”;
打印完整调用栈(Stack Trace)
若需打印整个调用链,应使用 runtime.Stack(buf, false)。它会将当前 goroutine 的调用栈写入提供的缓冲区中。
常用做法:
func PrintStackTrace() {buf := make([]byte, 4096)
n := runtime.Stack(buf, false)
fmt.Printf("Stack trace:\n%s", buf[:n])
}
在发生关键错误或 panic 前调用此函数,能输出完整的函数调用路径。
与错误处理结合:使用 errors.WithStack 或第三方库
标准库的 error 不自带堆栈,但可通过封装附加。推荐使用 github.com/pkg/errors 提供的 WithStack 方法。
示例:
import "github.com/pkg/errors"func doSomething() error {
return errors.New("something went wrong")
}
func main() {
if err := doSomething(); err != nil {
fmt.Printf("Error with stack:\n%+v\n", err)
}
}
注意使用 %+v 格式化输出,才能显示完整的堆栈信息。
在 defer 中捕获 panic 并打印调用链
利用 defer 和 recover 是记录异常调用链的常见模式。
示例:
func safeRun() {defer func() {
if r := recover(); r != nil {
fmt.Println("Panic caught:", r)
buf := make([]byte, 4096)
runtime.Stack(buf, true) // true 表示打印所有 goroutine
fmt.Printf("Full stack trace:\n%s", buf)
}
}()
panic("test panic")
}
这种机制适合服务型程序,在关键入口处保护运行逻辑。
基本上就这些。掌握 runtime 的调用链打印技巧,能显著提升 Go 程序的可观测性。不复杂但容易忽略。











