Go error默认不带堆栈，fmt.Printf("%+v", err)无输出是因为errors.New和fmt.Errorf("xxx")（不含%w）未调用runtime.Callers；仅pkg/errors.Wrap、Go 1.20+ fmt.Errorf("%w")配合自定义类型或手动实现fmt.Formatter的error才支持%+v展开堆栈。
Go 的 error 默认不带堆栈，想在生产环境快速定位异常源头，必须主动补全调用上下文——不是靠 panic 自动打印，而是靠包装、日志标记或运行时抓取。
为什么 fmt.Printf("%+v", err) 有时没堆栈？
因为 errors.New 和 fmt.Errorf("xxx")（不带 %w）创建的 error 是“空堆栈”类型：它只存字符串，不调用 runtime.Callers。只有以下情况才让 %+v 展开堆栈：
-
github.com/pkg/errors.Wrap(err, "msg")或errors.WithStack(err)—— 在包装那一刻捕获当前调用点 - Go 1.20+ 的
fmt.Errorf("xxx: %w", err)配合自定义 error 类型（需手动实现Unwrap()+ 堆栈字段） - 你自己用
runtime.Caller构造的 error，且实现了fmt.Formatter接口
常见错误：混用 errors.New(err.Error()) —— 原始堆栈彻底丢失；或在中间层反复 WithStack，结果只保留第一次的位置。
HTTP handler 入口统一捕获 panic + error 堆栈
不要等错误层层返回再处理。入口处用 defer/recover 捕获 panic，同时对业务返回的 error 主动加堆栈：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 在 handler 开头加：
defer func() { if r := recover(); r != nil { buf := make([]byte, 4096); runtime.Stack(buf, false); log.Printf("PANIC: %s\n%s", r, buf) } }() - 所有业务函数返回前，对非 nil error 调用一次
github.com/pkg/errors.WithStack(err)（仅最外层，比如 handler 或 service 入口） - 日志输出必须用
fmt.Printf("err: %+v\n", err)，不能用log.Print(err)或sprintf("%v", err)—— 后者不触发堆栈格式化 - 若用
zap，直接传zap.Error(err)即可，它会自动提取pkg/errors的堆栈字段
不用第三方库时怎么轻量加堆栈？
标准库不提供带堆栈的 error 构造器，但可用最小闭环实现：
- 导入
runtime，在错误构造处调用runtime.Caller(1)获取文件、行号、函数名 - 把这三者拼进错误消息，例如：
fmt.Errorf("%s:%d %s: %w", file, line, fn, origErr) - 注意：
runtime.Caller(1)返回的是调用它的函数位置，2才是业务代码位置；若函数被内联，fn可能为空 - 更稳妥的做法是配合
log.SetFlags(log.Lshortfile | log.LstdFlags)，让每条日志自带位置 —— 虽无完整调用链，但至少知道哪一行开始处理错误
debug.PrintStack() 和 runtime.Stack() 别乱用
两者都输出当前 goroutine 堆栈，但适用场景不同：
-
debug.PrintStack()直接写到os.Stderr，无返回值，适合开发期临时埋点；但它不带格式、易被日志淹没，**生产环境慎用** -
runtime.Stack(buf, false)返回字节数组，可控性强，适合拼进 error 或日志字段；但要注意 buf 大小（建议 ≥ 4KB），否则截断 - 它们捕获的都是「执行到此处时」的堆栈，不是错误最初发生的点 —— 若错误是多层返回上来的，这里记录的是最后处理它的位置，不是源头
- 高频调用有性能开销，别放在 hot path（如每请求都调）
真正难的不是“怎么打堆栈”，而是判断该在哪一层加、加几次、以及如何避免日志里暴露敏感路径又不让运维失去定位能力 —— 这些得结合服务分层和错误分类策略来定。
