异步刷盘必须与脱敏解耦，脱敏须在主线程完成并生成终态LogEntry后才进入异步通道；否则因上下文丢失导致panic或性能劣化。
直接结论：异步刷盘必须和脱敏解耦，脱敏应在日志进入异步通道前完成；否则要么丢失敏感字段（因异步延迟导致上下文失效），要么在消费协程里做脱敏引发锁竞争或 panic。
为什么不能在异步写入 goroutine 里做脱敏
脱敏逻辑常依赖请求上下文（如 req.Context()）、调用栈信息、或动态配置（如当前租户 ID），而这些在后台 goroutine 中早已不可见或已失效。更严重的是，若脱敏函数含正则编译、JSON 解析等操作，会显著拖慢批量刷盘节奏，使缓冲区堆积、触发 channel 阻塞，最终反向卡住业务。
- 常见错误现象：
panic: runtime error: invalid memory address or nil pointer dereference出现在后台日志协程中，实际是脱敏时访问了已释放的*http.Request - 性能影响：单条脱敏耗时从 0.2ms 升至 1.8ms，1024 条缓冲区 flush 周期从 50ms 拉长到 200ms+，write 系统调用频次不降反升
- 正确做法：所有脱敏必须在主线程完成，生成终态
LogEntry后才发往logChan
如何安全地在主线程完成结构化脱敏
关键不是“能不能脱敏”，而是“怎么保证脱敏结果可序列化且不污染原始数据”。推荐用浅拷贝 + 字段白名单 + 预编译正则的方式，避免运行时反射开销。
- 定义脱敏规则时，用
map[string]*regexp.Regexp预热（如pwdReg = regexp.MustCompile(`(?i)password\s*[:=]\s*["']?[^"'\s]+`)），而非每次调用都regexp.Compile - 对传入的
map[string]interface{}做浅拷贝（copy(mapKeys, keys)），仅遍历白名单键（如[]string{"user_id", "phone", "id_card"}）做替换，跳过未知 key - 敏感值替换统一用固定掩码（如
"***"），不拼接原始长度（避免泄露位数信息） - 示例片段：
func redactFields(data map[string]interface{}) map[string]interface{} { out := make(map[string]interface{}) for k, v := range data { if _, ok := redactKeys[k]; ok { out[k] = "***" } else { out[k] = v } } return out }
异步刷盘必须带超时与满载双触发机制
只靠缓冲区满才 flush，会在线上低流量时段造成日志延迟高达数秒；只靠定时器 flush，又可能在突发流量下把缓冲区撑爆。Zap 的 zapcore.NewAsyncCore 默认就是双触发，自研也必须照搬。
立即学习“go语言免费学习笔记（深入）”；
- 缓冲区大小设为
1024是平衡点：太小（如 128）导致频繁 flush；太大（如 8192）OOM 风险陡增，且 GC 压力明显 - 超时阈值建议
100ms而非默认 1s——Web 接口超时通常在 300ms～2s，日志延迟应控制在 1/3 以内 - 必须用
bufio.Writer包裹文件句柄，WriteString直写效率极低；Flush()前检查w.Buffered() >= 16 * 1024可进一步减少系统调用 - 错误处理不能忽略：
if err != nil { _ = file.Truncate(0); log.Printf("log write failed: %v", err) }，防止单次失败导致后续全丢
滚动切片和 fsync 必须分开控制
很多人以为 lumberjack.Logger 自动 fsync，其实它默认关闭。高危操作（如 ERROR 日志）必须强制落盘，但 INFO 日志无需 fsync —— 否则吞吐量直接跌 70%。
- ERROR 级别绕过异步通道：用
zapcore.NewTeeCore(syncCore, asyncCore)，其中syncCore对应带fsync的 writer -
lumberjack.Logger的LocalTime设为true，避免时区转换开销；MaxSize控制在100 （100MB），过大则 <code>write调用耗时飙升 - 不要在日志路径里用
os.Getwd()或相对路径——容器环境下极易指向/，导致权限失败或写入根分区
真正难的不是写一个异步 channel，而是让脱敏不丢上下文、刷盘不卡业务、滚动不崩盘。这三个点任何一处松动，线上就会出现日志延迟、敏感泄露、磁盘打满一类问题，而且很难复现。
