logrus hook 在 entry.log() 格式化后触发，不可修改已固化字段；需注意并发安全、异步上报、trace_id 注入、loki 级别绕过及 panic 堆栈捕获等生命周期陷阱。
Logrus Hook 的执行时机与生命周期陷阱
Logrus 的 Hook 不在日志写入前“拦截”，而是在 Entry.Log() 完成格式化、准备写入时触发——这意味着你无法修改 Entry.Data 中已存在的字段（如 time、level），但可以读取、补充字段或发起异步上报。
常见踩坑点：
- 在
Fire()方法里调用entry.Data["msg"] = "xxx"无效：此时entry.Message已固化，Data仅用于字段注入，不参与最终文本拼接 - Hook 实例被多个 goroutine 并发调用，但
Fire()本身无锁——若你在 Hook 内做共享状态统计（如计数器），必须手动加sync.Mutex - 若 Hook 执行耗时（如 HTTP 上报），会阻塞当前日志调用线程；生产环境务必用 goroutine + channel 异步解耦，否则拖慢主流程
实现带 trace_id 和 service_name 的结构化 Hook
多数微服务场景需要将请求链路 ID 和服务名自动注入每条日志。Logrus 本身不传递上下文，需靠外部传入或从 context 包提取——推荐在中间件/入口处将 trace_id 注入 log.Entry，再由 Hook 提取并透传。
实操建议：
- 不要在 Hook 里尝试从
http.Request.Context()取值：Hook 没有 request 对象，且日志可能来自非 HTTP 场景（如定时任务） - 统一使用
log.WithFields(log.Fields{"trace_id": tid, "service_name": "user-svc"})构建 entry，Hook 中通过entry.Data["trace_id"]读取 - 若需兼容无 trace_id 场景，Hook 内应 fallback 到
uuid.New().String()，避免字段缺失导致采集端解析失败 - 结构化输出到文件时，确保
log.SetFormatter(&log.JSONFormatter{})，否则trace_id会混在纯文本末尾，丧失可解析性
对接 Loki 的 Pusher Hook 需绕过 Logrus 的 Level 过滤
Loki 官方推荐用 Promtail 抓取日志文件，但直连 Loki API 的 Pusher Hook 更灵活。问题在于：Logrus 默认只把满足 Level >= logger.Level 的日志交给 Hook，而 Loki 常需采集 debug 级别日志做排查——但又不想让 debug 日志刷屏控制台。
解决方案是拆分 Logger 实例：
- 保留主
*log.Logger输出到 console，SetLevel(log.InfoLevel) - 另建一个
*log.Logger专供 Loki，SetLevel(log.DebugLevel)，但不挂任何 output，只挂你的LokiHook - 关键：调用该 logger 时显式传入完整 entry，例如
lokiLogger.WithFields(e.Data).Log(e.Level, e.Message)，避免被主 logger 的 level 过滤掉 - Loki API 要求每条日志带
timestamp（纳秒）、labels（map[string]string），务必用entry.Time.UnixNano()转换，且labels中不能含空格或特殊字符（如service.name需转为service_name）
Hook 中处理 panic 日志的特殊路径
Go 的 recover() 日志通常由框架（如 Gin）捕获后调用 log.Error()，但部分 panic 发生在框架外（如 goroutine 内部），需用 recover() + log.Panic() 主动上报。此时 Hook 收到的 Entry.Level 是 log.PanicLevel，但默认 JSONFormatter 不会输出 panic 的 stacktrace。
正确做法：
- 在 Hook 的
Fire()中判断entry.Level == log.PanicLevel，然后手动调用debug.PrintStack()或runtime/debug.Stack()获取堆栈 - 不要直接拼接进
entry.Message：会导致重复打印（formatter 已输出 message）。应作为独立字段写入：entry.Data["stacktrace"] = string(stack) - 注意
runtime/debug.Stack()返回字节切片，长度上限默认 1MB，超长会被截断；若需完整堆栈，改用runtime/debug.Stack()并配合理解 buffer 大小限制 - panic 日志量少但关键，建议 Hook 单独走高优先级通道（如 Sentry webhook），而非和普通日志共用 Loki 或 ES
多维度日志采集真正的复杂点不在 Hook 编写，而在字段来源的一致性：trace_id 从哪来、service_name 怎么配置、环境标识（prod/staging）是否随部署自动注入——这些必须和配置中心、启动参数、CI/CD 流程对齐，否则 Hook 再完善也白搭。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
