Golang日志处理技巧与优化方法

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang log包日志处理技巧》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

log.Printf支持格式化输出，log.Println仅空格拼接；SetFlags可添加时间戳和行号；Fatal/Panic在HTTP handler中禁用，避免进程退出；SetOutput可切换输出目标且线程安全。

log.Printf 和 log.Println 有什么实际区别？

主要区别在参数处理和格式控制：log.Printf 支持格式化字符串（类似 fmt.Printf），而 log.Println 只做简单空格拼接，不支持占位符。

常见误用是把带变量的日志硬塞进 log.Println，结果输出一串地址或类型名——比如 log.Println("user:", user) 中 user 是结构体，会打印其内存表示，而非字段内容。

• log.Printf("user id=%d, name=%s", user.ID, user.Name) —— 正确，可控、可读
• log.Println("user id=", user.ID, "name=", user.Name) —— 可行但冗长，且无法对齐或加前缀
• 避免 log.Println("error:", err.Error())，直接用 log.Printf("error: %v", err)

如何让 log 输出带时间戳和文件行号？

标准 log 包默认不带这些信息，需通过 log.SetFlags 启用。关键标志位有：log.LstdFlags（日期+时间）、log.Lshortfile（文件名:行号）、log.Lmicroseconds（微秒级时间）。

注意：log.Lshortfile 会降低性能（需运行时解析调用栈），生产环境慎用；调试阶段建议组合使用：

log.SetFlags(log.LstdFlags | log.Lshortfile | log.Lmicroseconds)
log.Printf("request processed") // 输出类似：2024/05/22 14:23:11.123456 handler.go:42: request processed

• 不要用 log.Llongfile，路径太长且无必要
• 如果已用 log.SetOutput 重定向到文件，SetFlags 仍生效
• 多个 goroutine 共享同一 *log.Logger 是安全的

为什么不能直接用 log.Fatal 结束 HTTP handler？

log.Fatal 内部会调用 os.Exit(1)，导致整个进程退出——这对 Web 服务是灾难性的，一次错误请求就让所有连接中断。

HTTP handler 中应只记录错误并返回响应，例如：

func handler(w http.ResponseWriter, r *http.Request) {
    if err := doSomething(); err != nil {
        log.Printf("handler failed: %v", err) // 记录，但不退出进程
        http.Error(w, "internal error", http.StatusInternalServerError)
        return
    }
    // ...
}

• log.Panic 同样危险，它触发 panic，可能被上层 recover，但不可靠
• 真正该用 log.Fatal 的场景极少：main 函数初始化失败（如无法绑定端口、加载配置失败）
• 若需终止当前请求上下文，用 return 或 http.Error 即可

log.SetOutput 能否切换到不同文件或 stdout/stderr？

可以，而且非常常用。只要传入实现了 io.Writer 接口的对象即可，比如 os.Stdout、os.Stderr、os.File，甚至自定义的带缓冲或轮转的 writer。

典型做法是按环境区分输出目标：

if os.Getenv("ENV") == "prod" {
    f, _ := os.OpenFile("/var/log/myapp.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
    log.SetOutput(f)
} else {
    log.SetOutput(os.Stdout)
}

• 切换 log.SetOutput 是线程安全的，但频繁切换可能引发竞态（比如两个 goroutine 同时调用）
• 如果写入文件，记得在程序退出前 f.Close()，否则日志可能丢失
• 标准库不支持日志轮转，需要借助第三方包（如 lumberjack）或自行封装

日志不是越详细越好，关键是能快速定位问题。别依赖 log.Lshortfile 查 bug，先确保每条日志都有明确上下文（比如请求 ID、用户 ID），再考虑加行号。

今天关于《Golang日志处理技巧与优化方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！