zap.NewProduction()不是异步的，它同步写入、无缓冲、无队列；真要异步刷盘，必须用zapcore.NewAsyncCore手动组装Core，且不能只套goroutine——否则日志丢、延迟高、OOM风险大。
直接说结论：zap.NewProduction() 不是异步的，它同步写入、无缓冲、无队列；真要异步刷盘，必须用 zapcore.NewAsyncCore 手动组装 Core，且不能只套 goroutine —— 否则日志丢、延迟高、OOM 风险大。
为什么 zap.NewProduction() 不能当异步用
它返回的 logger 看似“快”，但底层仍是裸 *os.File 或 os.Stderr，每次调用 logger.Info() 都会阻塞当前 goroutine 直到 write() 系统调用完成。现象很典型：
- HTTP handler P99 延迟突然从 2ms 涨到 40ms+，pprof 显示大量时间卡在
syscall.Syscall - 日志量一上来（比如每秒 3k 条），CPU 毛刺明显，GC Pause 升高
- 目标是 Kafka 或慢盘时，业务完全被拖住，甚至超时熔断
所谓“高性能”只来自零分配编码器，不是 I/O 并发能力。它连缓冲区都没有，更别说背压控制。
用 zapcore.NewAsyncCore 实现可靠异步刷盘
这是 Zap 官方唯一推荐的异步方案，内部用无锁环形缓冲 + 批量刷盘 + 内存复用，不是简单开 goroutine。启用方式必须是：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
logger := zap.New(zap.WrapCore(func(core zapcore.Core) zapcore.Core {
return zapcore.NewAsyncCore(encoder, writer, level, 4096)
}))
关键点：
-
bufferSize设 1024～8192：太小（如 128）易满导致丢日志；太大（如 65536）P99 延迟可能超 200ms -
writer必须是zapcore.WriteSyncer，例如zapcore.AddSync(zapcore.Lock(lumberjackLogger)) - 别传
*os.File直接进去——它不支持并发写，得包一层zapcore.Lock - 峰值 QPS 超 5w 时，纯内存缓冲扛不住，得加本地磁盘队列兜底（如
file-rotatelogs+io.MultiWriter）
语言学习系统监控中容易踩的坑
这类系统常有高频用户行为日志（如单词点击、发音评分、答题提交），字段多、结构深，稍不注意就拖垮服务：
- 别全局开
zap.AddCaller()：每次触发runtime.Caller，耗时涨 15%，只在ERROR级别用zap.AddCallerSkip(1) - 字段名用下划线而非驼峰：Zap 默认输出
httpStatus，但 Loki / Datadog 习惯http_status，字段不匹配 → Kibana 查不到日志 - 关键错误（如 DB 连接失败、ASR 服务不可用）绝不能走异步通道：单独配一个带
os.O_SYNC的*os.File，直写 + 显式file.Sync() - 轮转日志别用
lumberjack默认配置：rotate 瞬间同步压缩，延迟飙到 200ms+，且时间戳错乱；务必设LocalTime: true和Compress: false，rotate 动作扔进独立 goroutine
Sync() 不是可选操作，而是保底手段
异步日志本质是“尽力而为”，进程崩溃时缓冲区内容全丢。所以：
-
defer logger.Sync()没用——崩溃时根本不会执行 - 进程退出前（如
os.Interrupt信号处理）必须显式调logger.Sync() - 关键错误日志直写后，立刻跟
file.Sync()，别依赖 defer - 如果用了
zapcore.NewTeeCore(syncCore, asyncCore)双写，syncCore仍需自己保证落盘
真正难的不是配出异步，而是平衡延迟、可靠性与资源占用——缓冲大小、是否双写、何时 sync，每个选择都得看你的 QPS 曲线和故障容忍度。
