最简可用的自定义 slog.Handler 需实现 Enabled(返回 true 控制日志是否处理)和 Handle(遍历 record.Attrs(),对 slog.KindGroup 递归展开,用 record.Time.Format(time.RFC3339Nano) 保留纳秒精度,避免直接操作临时切片或耗时操作)。

怎么写一个最简可用的自定义 slog.Handler
直接实现 slog.Handler 接口就行,核心是重写 Handle 方法。它接收 slog.Record,你要做的就是把里面的时间、级别、消息、键值对转成你想要的格式(比如写文件、发 HTTP、加 traceID)。
注意:别漏掉 Enabled 方法——它控制日志是否该被处理。如果没实现或返回 false,你的 Handle 根本不会被调用。
-
Handle里别直接操作Record.Attrs()返回的切片——它是临时的,下次调用可能被复用;要用record.Attrs()遍历时拷贝值 - 如果要支持结构化字段(比如嵌套 map),得手动递归展开
slog.GroupValue,Record不自动扁平化 - 别在
Handle里做耗时操作(如网络请求、磁盘 sync),会阻塞日志调用方;异步写入需自己管理 goroutine + channel,注意背压
为什么 WithGroup 和 With 在自定义 Handler 里表现不一样
因为 slog.Record 把 WithGroup 的字段包装成了 slog.GroupValue 类型,而 With 的是普通 slog.AnyValue 或 slog.StringValue。如果你只遍历 record.Attrs() 并用 v.Any() 取值,遇到 Group 就会得到 nil 或 panic。
- 正确做法:对每个
slog.Attr,先判断attr.Value.Kind() == slog.KindGroup - 再用
attr.Value.Group()拿到子字段,递归处理 - 常见坑:用
fmt.Sprint(attr.Value)打印 Group,输出是{0xc000102000}这种地址,不是内容
如何让自定义 Handler 支持 JSON 输出但保留时间精度
默认 slog.JSONHandler 把 time.Time 序列化成 RFC3339 字符串(秒级),但 Record.Time 是纳秒精度的 time.Time。如果你自己写 JSON 输出,直接 json.Marshal(record.Time) 会丢精度或出错(因为 time.Time 没导出字段)。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 用
record.Time.Format(time.RFC3339Nano)手动格式化,确保纳秒级字符串 - 别依赖
json.Marshal默认行为——它对 time.Time 的处理取决于time.Time的 MarshalJSON 方法,而该方法默认用 RFC3339(秒级) - 如果要兼容
slog.HandlerOptions.ReplaceAttr,记得在自定义Handle前先调用它处理 attrs,否则ReplaceAttr不生效
为什么加了自定义 Handler 后日志突然不输出了
大概率是 Enabled 方法返回了 false,或者 Handle 里 panic 了但没 recover(slog 会静默吞掉 panic)。
- 检查
Enabled是否无条件 return false,或逻辑写反(比如把level >= slog.LevelInfo写成) - 在
Handle开头加defer func(){ if r := recover(); r != nil { fmt.Fprintln(os.Stderr, "slog handler panic:", r) } }()快速定位崩溃 - 确认是否调用了
slog.SetDefault(slog.New(yourHandler)),否则还是走默认的 console handler - Windows 下路径分隔符写错(比如硬写
"logs/app.log"而没用filepath.Join),导致os.OpenFile失败且没报错
真正麻烦的是字段嵌套深度和并发写入冲突——这两个点不报错,但输出错乱或丢失,得靠日志比对才能发现。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










