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

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

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

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 格式化器凭空猜测文件名。

用最小程序核对输出字段

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

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 设计；不要用修改日志文本来掩盖定位偏差。

什么时候值得打开，什么时候应该谨慎

本地开发和故障复现

本地排查时，调用位置通常比少几个字节更有价值。可以在开发配置中固定开启，配合短生命周期日志快速回到具体代码。

生产日志与高频路径

生产环境要看日志量、采集字段和脱敏要求。源码路径可能暴露部署目录；日志量很大时，额外字段也会增加传输与索引开销。更稳妥的方式是让环境变量控制 AddSource，只在诊断窗口或指定级别的处理器上开启。

自定义 Handler

自定义 Handler 时要遵守并发调用约束，并正确处理记录中的位置字段。若实现直接丢弃或重写了源信息，最终输出自然不会和内置处理器一致。先用同一条日志同时接入内置 JSONHandler 和自定义处理器做对照。

一份可以落地的检查清单

• 确认配置对象确实传给了当前使用的 Handler，而不是创建后又被默认 Logger 覆盖。
• 用固定消息在本地核对 SourceKey 是否出现，再检查路径是否指向业务调用行。
• 检查日志采集规则是否会索引 source 字段，以及路径是否需要脱敏或裁剪。
• 对高频日志做一次输出量对比，不要把“能看到文件行号”直接等同于“没有成本”。

相关问题

AddSource 默认是开启的吗？

不是。slog.HandlerOptions 的零值保持默认行为，AddSource 需要显式设置为 true。

为什么日志里的 source 不是业务调用位置？

最常见原因是日志经过了包装函数。先检查封装层的调用位置处理，再用内置处理器对照验证。

只使用 JSONHandler 才能输出 source 吗？

不是，TextHandler 和 JSONHandler 都使用 HandlerOptions，具体呈现形式由处理器决定。

把开关放回日志策略

AddSource 适合用来缩短定位路径，但它应该是日志策略的一部分：开发环境偏向可诊断性，生产环境同时权衡吞吐、路径信息和采集成本。先用最小程序确认字段，再把开关接入环境配置，通常比全局无条件打开更容易维护。