17370845950

如何使用Golang日志与错误结合_记录文件和终端输出
Go 标准库 log 包需通过 io.MultiWriter 实现终端与文件双写入,并用 %+v 格式化错误以保留堆栈;可封装带前缀的 logger 模拟级别,大规模项目推荐 zap 或 zerolog 等结构化日志库。

Go 语言标准库的 log 包本身不直接支持错误类型自动展开,但通过合理封装和组合,可以实现「错误信息 + 上下文日志」同时输出到文件和终端,并保持结构清晰、可读性强。

使用 log.SetOutput 同时写入多目标

Go 的 log.Logger 支持自定义输出目标(io.Writer)。你可以用 io.MultiWriter 将日志同时发给 os.Stdout 和文件句柄:

  • 打开日志文件(建议用 os.OpenFile 配合 os.O_APPEND | os.O_CREATE | os.O_WRONLY
  • 创建 io.MultiWriter,传入 os.Stdout 和文件句柄
  • 调用 log.SetOutput 或新建 log.New 实例绑定该 writer

这样所有 log.Print/Printf/Println 调用都会同步出现在终端和文件中。

让错误对象自动转为可读字符串

标准 log 打印 error 时默认只调用 err.Error(),丢失堆栈。推荐两种轻量方案:

  • fmt.Printf("%+v", err):若使用 github.com/pkg/errors 或 Go 1.13+ 的 errors.Unwrap / %w%+v 可显示完整调用链
  • 封装一个带错误上下文的日志函数,例如:
    func LogError(msg string, err error) {
    log.Printf("%s: %+v", msg, err)
    }

    这样既保留业务提示(如 "failed to parse config"),又附带结构化错误详情。

区分日志级别并保留错误语义

标准 log 没有内置级别,但可通过前缀模拟(如 [ERROR][WARN]):

  • 定义不同 logger 实例:log.New(mw, "[ERROR] ", log.LstdFlags)
  • 在错误路径中统一使用 errorLogger.Println(...),正常流程用 infoLogger
  • 关键错误建议额外调用 log.Fatal(会自动加换行并退出),或手动 os.Exit(1)

注意:不要把非致命错误都塞进 Fatal,否则掩盖真正需终止的场景。

进阶:结构化日志(可选)

如果项目规模上升,建议切换到结构化日志库,比如:

  • zap(高性能,推荐生产):支持 logger.Error("db query failed", zap.Error(err), zap.String("query", sql))
  • zerolog(零分配,链式 API):log.Error().Err(err).Str("path", r.URL.Path).Msg("request failed")

它们天然支持错误字段序列化、JSON 输出、多写入器(console + file + network),比手写更健壮且易扩展。