最轻量方案是直接封装函数，关键三点：捕获真实状态码、用r.RequestURI取原始路径、禁用JSON Unicode转义；漏任一都会导致日志不可靠。
直接封装成函数最轻量，别搞结构体+方法的冗余包装；核心是捕获真实状态码、用 r.RequestURI 取原始路径、禁用 JSON Unicode 转义——这三点漏掉任意一个，日志就不可靠。
为什么不能直接在 handler 里 log.Printf
因为没包装 ResponseWriter，拿不到真实状态码；r.URL.Path 在反向代理后常为 /，而 r.RequestURI 才是服务端收到的原始字符串；更关键的是，handler 内部调用 log.Printf 后再调 next.ServeHTTP，一旦响应已写入，后续中间件或业务逻辑再写就会 panic。
- 错误现象：
http: multiple response.WriteHeader calls或write on closed body - 根本原因：没拦截
WriteHeader和Write，状态码和响应体长度无法捕获 - 正确做法：必须用自定义 wrapper 类型实现
http.ResponseWriter接口
responseWriterWrapper 必须实现哪两个方法
WriteHeader 和 Write 是唯二必须重写的，其他方法可匿名嵌入原 ResponseWriter。重点不是“全量实现”，而是确保状态码不丢失、响应体长度可统计。
-
WriteHeader(statusCode int)：立即存到字段，设written = true -
Write(b []byte)：若status == 0，fallback 到http.StatusOK；否则累加size - 别在
Write里调WriteHeader——HTTP 规范禁止多次调用 - 不要实现
Hijack或Flush，除非你真需要长连接或流式响应
JSON 日志里中文变 \u4f60\u597d 怎么办
这是 json.Marshal 默认行为，不是 bug，但生产日志必须关掉。标准库 json.Encoder 的 SetEscapeHTML(false) 只影响 <>，对 Unicode 无效；要彻底禁用 Unicode 转义，得绕过标准 json 包。
立即学习“go语言免费学习笔记（深入）”；
- 方案一（推荐）：用
go-json库，它默认不转义 Unicode，且性能比标准库高 3–5 倍 - 方案二（轻量）：自己实现
MarshalJSON方法，对字符串字段不做转义 - 绝对避免：
json:",string"标签——会让数字变成字符串，ES/Kibana 解析成keyword类型 - 时间戳别用
time.Now().Format("2006-01-02T15:04:05Z07:00")，改用time.Now().UnixMicro()
request ID 和并发安全怎么处理
别用 ctx.Value 传 request ID，容易被上层中间件覆盖；r.Header.Get("X-Request-ID") 直接取最稳。所有日志字段里，只有 r.Header 是并发安全的；r.FormValue 会触发 ParseForm，可能修改 r.Body，导致后续读取失败。
- 敏感参数（如
password、token）必须在日志前脱敏，不能等入库再处理 - 别在日志里调
mux.CurrentRoute(r).GetName()——路由未匹配时 panic - 如果用了
gorilla/mux，应在中间件外先做route := mux.CurrentRoute(r)判断非 nil 再取名 - 采样日志（如只记录 1% 的请求）必须用原子计数器，别用全局变量加锁
最易被忽略的是：日志中间件必须在所有其他中间件最外层注册，否则像认证、限流这些中间件抛出的错误，状态码就捕获不到；另外，r.RequestURI 带查询参数，脱敏逻辑得跑在日志序列化之前，而不是之后。
