17370845950

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 函数：

• 接收格式字符串和参数，内部自动加前缀、写入 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)