17370845950

Go log包不支持自动捕获调用栈，需结合errors.Wrap或fmt.Errorf("%w")包装错误并用"%+v"打印，或用runtime.Caller手动注入位置信息，避免裸错误返回和log.Fatal误用。

Go 标准库的 log 包本身不支持自动捕获调用栈，但结合 errors（尤其是 Go 1.13+ 的包装错误）和第三方工具（如 github.com/pkg/errors 或原生 runtime.Caller），可以记录带文件名、行号、函数名的详细错误上下文。关键在于：错误要被“包装”而非覆盖，日志要主动提取并输出调用位置。

使用 errors.Wrap 或 fmt.Errorf(%w) 包装错误

原始错误丢失上下文，必须在每一层调用中显式包装，保留原始错误链和当前位置信息：

• 推荐用 Go 1.13+ 原生方式：fmt.Errorf("处理用户失败: %w", err) —— 自动携带调用点（需开启 -gcflags="-l" 编译，或依赖运行时解析）
• 若需更稳定的位置信息，用 github.com/pkg/errors：errors.Wrap(err, "validate input")，它在创建时就记录 runtime.Caller(1)
• 避免直接返回裸错误（如 return err），否则上层无法知道该错误发生在哪一层

日志中打印错误详情与堆栈（非 panic 场景）

标准 log 不解析错误堆栈，需手动展开。对 pkg/errors 错误可用 errors.WithStack() + errors.PrintStack()；对原生 %w 错误，可用 fmt.Printf("%+v", err) 输出带行号的完整链：

• 记录时用 log.Printf("failed to save user: %+v", err) —— %+v 是关键，会显示每层包装的文件/行号/函数
• 若用 logrus 或 zap 等结构化日志库，可配合 github.com/mitchellh/go-homedir 简化路径，或自定义字段写入 errors.Cause(err).Error() 和 fmt.Sprintf("%+v", err)
• 注意：不要在生产环境频繁用 %+v 打印深层堆栈（性能开销略高），建议仅在 error 级别日志中使用

手动补充调用位置到日志（轻量替代方案）

不依赖错误包装时，可在日志语句中主动注入位置信息：

• 用 runtime.Caller(1) 获取上层调用点：_, file, line, _ := runtime.Caller(1); log.Printf("[%s:%d] failed: %v", filepath.Base(file), line, err)
• 封装成辅助函数：LogError(err error, msg string)，内部自动追加位置，统一管理格式
• 适合简单服务或已有大量裸错误未包装的迁移过渡期

避免常见陷阱

• 不要用 log.Fatal 替代错误处理——它会直接退出进程，掩盖真实错误传播路径
• 不要在 defer 中用 recover() 后只打 err.Error() —— 丢失堆栈，应打 debug.Stack() 或 fmt.Sprintf("%+v", err)
• HTTP handler 中不要把错误全打成 log.Println，而要用结构化字段（如 req_id, path, status）关联错误日志，便于追踪