go日志中间件必须异步推送日志到loki，禁止在http handler中同步调用client.push()，否则会阻塞请求、丢日志、压垮loki；正确做法是通过缓冲通道+后台goroutine攒批推送，并严格规范labels构造。
Go日志中间件不能也不该“同步”推送日志到Loki——直接在HTTP handler里调用client.Push()会阻塞请求、丢日志、压垮Loki；正确做法是把日志写进缓冲通道，由后台goroutine异步批处理。
为什么中间件里不能直接调用loghttp.Client.Push
常见错误是：在HTTP handler里拿到logger.With().Str("trace_id", tid).Logger()后，立刻logger.Info().Msg("request start")，再同步调用lokiClient.Push()。这会导致：
- 每次HTTP请求都发起一次HTTP round-trip，延迟叠加，P99响应时间飙升
- Loki临时不可用时，handler卡在
Push()超时（默认30s），连接堆积 - 没做batch，单条日志发POST，Loki端拒绝高频小请求（报429或413）
- 没设
BatchWait，loghttp.Client内部缓冲几乎不触发，等于白配
用zerolog + loghttp搭异步管道
核心思路：让中间件只负责构造带上下文的zerolog.Logger，日志输出重定向到内存缓冲区，再由独立goroutine攒批、加labels、调用loghttp.Client.Push。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 初始化
loghttp.Client时必须设BatchWait: 5 * time.Second（默认1s太激进）和MaxBatchSize: 1024 - 用
zerolog.New(zerolog.NewConsoleWriter())只是调试用；生产必须用io.MultiWriter(os.Stdout, yourBuffer)，其中yourBuffer是自定义io.Writer实现 - 自定义
Write(p []byte)方法：把p解析为JSON，提取service、trace_id等字段，塞进loghttp.LogEntry.Labels，再推入chan []loghttp.LogEntry - 启动一个goroutine从channel收日志，每5秒或满100条就调一次
client.Push()，失败时重试3次并退避
标签怎么从HTTP请求动态注入到Loki
Loki查不到日志？大概率是Labels没对上。中间件能拿到的动态信息（如trace_id、method、status_code）必须显式转成label，不能只塞进JSON body。
- 别写
{"trace_id":"abc123","msg":"ok"}——Loki不会自动把trace_id当label索引 - 必须在
loghttp.LogEntry里填Labels: `{job="auth", trace_id="abc123"}`（注意是字符串，不是map） - 静态label（如
env、job）用os.Getenv("ENV")初始化；动态label（如trace_id）从r.Header.Get("X-Trace-ID")或chi.RouteContext(r.Context()).URLParams取 - 避免label爆炸：
request_id这种高频唯一值别放Labels，留在Entry.Line里，用{job="auth"} | json | __error__查
调试时怎么确认日志真进了Loki
别只看Grafana Explore有没有数据——先验证Loki是否收到了series（即标签组合）。
- curl
http://loki:3100/loki/api/v1/series?match=%7Bjob%3D%22auth%22%7D，返回空数组说明series根本没创建，问题出在label格式或push路径 - 检查
Labels字符串是否含非法字符：空格、双引号、斜杠——Loki会静默拒收，且不报错 - 用
curl -v -X POST http://loki:3100/loki/api/v1/push -H "Content-Type: application/json" --data-binary @payload.json手动发一条最简日志（含streams外层包装），排除client封装问题 - 如果
loghttp.Client没报错但Loki收不到，十有八九是timestamp字段类型错了：必须是纳秒字符串（strconv.FormatInt(time.Now().UnixNano(), 10)），不是int64也不是RFC3339Nano格式
真正难的不是写通那几行Push代码，而是让每条日志的Labels结构稳定、可预测、不爆炸——Loki的查询能力完全依赖这个，而HTTP中间件恰恰是最容易把各种临时字段塞进label的地方。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
