当前位置：首页 > 文章列表 > Golang > Go教程 > Go slog.HandlerOptions AddSource 如何控制调用位置信息：日志字段与性能边界

Go slog.HandlerOptions AddSource 如何控制调用位置信息：日志字段与性能边界

来源：17golang原创 2026-08-28 06:30:27 0浏览收藏

线上日志里只有时间、级别和消息，值班同事却总要先回源码猜是哪一行打出来的。Go 的 log/slog 可以让处理器补上调用位置，但 AddSource 不是“多打印一个字符串”这么简单：它会让处理器计算日志语句的源码位置，并以 SourceKey 属性写入输出。是否开启，应该按日志用途和采集成本来定。

开发和故障定位可以开启 HandlerOptions.AddSource；高吞吐的常规信息日志先评估输出体积、路径暴露和调用位置计算成本，再决定是否全量启用。

要点速览

AddSource 的职责是计算日志调用位置并添加 SourceKey。
位置字段来自记录创建时保存的程序计数器，处理器在输出阶段解析它。
包装 Logger 或自定义 Handler 时，要确认调用栈位置仍指向业务日志行。
生产环境可以只给诊断日志开启，或通过环境配置切换，避免盲目全量增加字段。

AddSource 到底改变了什么

slog.TextHandler 和 slog.JSONHandler 都接受 slog.HandlerOptions。默认值中 AddSource 为 false，因此普通输出不会主动解析调用位置；设置为 true 后，处理器会在记录中加入源码位置属性。

handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
    AddSource: true,
})
logger := slog.New(handler)
logger.Info("cache refreshed", "key", "user:42")

这里的链路可以拆成三段：Logger 生成记录，Handler 接收记录，开启 AddSource 的处理器再把记录中的位置解析为 SourceKey。所以它不是由 JSON 格式化器凭空猜测文件名。

Go slog 中 Logger、Handler 与 SourceKey 的调用链

用最小程序核对输出字段

先把输出目标固定为标准输出，再分别运行关闭和开启两种配置。不要一开始就接入日志平台，否则平台自动补充的字段会把差异掩盖。

package main

import (
    "log/slog"
    "os"
)

func main() {
    handler := slog.NewTextHandler(os.Stdout, &slog.HandlerOptions{
        AddSource: true,
    })
    logger := slog.New(handler)
    logger.Info("cache refreshed", "key", "user:42")
}

核对时只看一个事实：输出是否多出类似 source=/path/to/main.go:17 的字段。文件绝对路径、相对路径和字段名称可能受处理器实现影响，但“由处理器根据记录位置写入”这一行为是 HandlerOptions 的契约。

如果你把日志调用封装成 func Info(msg string)，位置可能落在封装函数内部，而不是业务调用方。此时先确认封装层是否使用了合适的 caller skip 设计；不要用修改日志文本来掩盖定位偏差。

Go HandlerOptions 通过 AddSource 在默认路径与 SourceKey 输出之间切换