Go log包需自定义实现错误日志级别:通过SetOutput(os.Stderr)定向stderr、SetPrefix("[ERROR] ")标识、SetFlags控制格式;记录时须含error值与上下文,推荐logError封装函数及pkg/errors链式堆栈。

Go 标准库的 log 包本身不区分日志级别(如 debug/info/error),但可以通过自定义前缀、封装函数或结合 os.Stderr 实现清晰的错误记录。关键在于让错误信息包含上下文、堆栈(可选)和可读性,而不仅是 log.Print 一句。
使用 log.SetOutput 和 log.SetPrefix 区分错误输出
将错误日志定向到标准错误流,并添加统一前缀,便于识别和后续日志采集:
-
设置输出目标:调用
log.SetOutput(os.Stderr),确保错误不会混在 stdout 中 -
添加错误标识:用
log.SetPrefix("[ERROR] ")统一标记所有日志为错误来源 -
避免重复换行:启用
log.SetFlags(0)或仅保留必要标志(如log.Ldate | log.Ltime),防止自动换行干扰结构化输出
记录错误时务必包含原始 error 值和上下文
不要只打印错误字符串,要保留 error 类型以便判断或重试;同时补充发生位置、参数等上下文:
- 用
log.Printf("failed to open file %q: %v", filename, err)替代log.Println(err) - 对关键操作(如 HTTP 处理、DB 查询),在 defer 或 if err != nil 分支中记录完整上下文,例如:
log.Printf("user login failed (uid=%d, ip=%s): %v", userID, r.RemoteAddr, err)
简单增强:用 helper 函数封装 error 日志
避免重复写 log.Printf("[ERROR] ..."),定义一个短小的 logError 函数:
立即学习“go语言免费学习笔记(深入)”;
- 接收格式字符串和参数,内部自动加前缀、写入 stderr
- 示例:
func logError(format string, v ...interface{}) {
log.Output(2, fmt.Sprintf("[ERROR] "+format, v...))
}
调用logError("database timeout: %v", err)即可 - 若需行号/文件名,用
log.Output(2, ...)(2 表示跳过当前函数和调用者一层)
需要堆栈?轻量替代方案:用 debug.PrintStack 或第三方包
标准 log 不提供堆栈,但有低成本方式获取:
- 临时调试可用
debug.PrintStack()输出到 stderr(不推荐线上长期使用) - 生产环境建议引入轻量包如
github.com/pkg/errors或 Go 1.13+ 的fmt.Errorf("msg: %w", err)链式错误 +%+v格式化输出堆栈 - 示例:
err := pkgerrors.Wrap(err, "failed to process order")
log.Printf("error with stack: %+v", err)










