audit.Log() 不能直接用 goroutine 包裹，因局部变量引用可能导致空值或 panic，且高危操作需同步落库保证强持久化；日志数据须深拷贝、纯值类型传递，敏感字段提前脱敏，异步队列需带 buffer 和超时机制。
audit.Log() 为什么不能直接用 goroutine 包一层就完事
直接在 audit.Log() 外套个 go audit.Log(...)，看似异步，实则埋雷：日志内容可能引用局部变量（比如 req.Header 或临时 map），goroutine 延迟执行时这些内存早已释放，打出空值或 panic；更糟的是，高危操作（如删账号）若只异步记日志，进程 crash 就彻底丢失，违反审计“强持久化”底线。
真正安全的异步前提是：日志数据必须深拷贝、结构体字段全值传递，且关键操作仍需同步落库。例如把 audit.Event 定义为纯值类型，所有字段用 string、int64、time.Time 等，避免指针或 interface{}。
- 禁止传
*http.Request或context.Context进 goroutine —— 提前抽取出UserIP、UserID、Action等字段再传 - 对
op_data这类可能含敏感信息的字段，必须在进 goroutine 前完成脱敏（如手机号掩码、token 哈希截断） - 异步队列本身要带 buffer 和超时丢弃机制，防止背压导致内存暴涨
audit.Logger 应该用 lumberjack 还是 syslog？
选哪个不看性能，看部署环境和合规要求：lumberjack.Logger 适合物理机/虚拟机上跑的 Go 服务，能控制 MaxSize、MaxAge、LocalTime，但得自己管权限和路径（比如 /var/log/myapp/audit.log 要提前 chown）；syslog.New（来自 golang.org/x/sys/unix）才是 K8s 或等保场景下的标准解法 —— 它把日志发给系统 rsyslog 或 journald，由 sidecar 统一采集、加密、归档，审计日志不落地容器磁盘，规避权限和 rotate 风险。
- 本地开发：直接用
os.Stdout，省去配置 - K8s 环境：必须用
syslog.New(syslog.LOG_USER, syslog.LOG_NOTICE)，别碰文件写入 - 物理机生产环境：优先
lumberjack.Logger，设MaxAge: 180（满足等保 180 天留存），禁用Compress: true（压缩可能被篡改，审计要求防删改）
如何让 audit.Log() 自动带上 handler 文件名和行号
log.Printf 打出来的 file:line 总是指向封装层，不是业务代码位置。要定位到真实调用点，得用 runtime.Caller(2)：第一个是 runtime.Caller 自身，第二个是你的 audit.Log() 函数，第三个才是业务代码 —— 所以跳过两层才准。别用 Caller(1)，否则所有日志都标在 audit.go 第 42 行，失去追溯意义。
立即学习“go语言免费学习笔记（深入）”；
示例片段：
func Log(event Event) {
_, file, line, _ := runtime.Caller(2)
event.Source = fmt.Sprintf("%s:%d", filepath.Base(file), line)
// 后续 JSON 序列化写入
}
-
filepath.Base(file)比file全路径更简洁，避免日志里塞一堆/home/xxx/src/.../handler.go - 如果用
logrus，可用log.WithField("source", ...).Info(...)，但注意logrus.Entry不是线程安全的，每次都要新构造 - 别依赖
log.Lshortfile—— 它只作用于标准log实例，对自定义结构化输出无效
audit.Event 结构体字段怎么设计才不踩坑
字段不是越多越好，而是每个都得有明确用途和不可为空约束。漏掉 UserIP 或用错 RemoteAddr（反向代理后是内网地址），等于没审计；把 ResourceID 设成 int64 可能泄露内部主键规律，暴露数据库结构；时间用 time.Now() 本地时区，跨服务器日志对不齐。
-
UserIP必须从X-Forwarded-For或X-Real-IP取， fallback 到req.RemoteAddr，并做 IP 校验（防止 header 注入） -
ResourceID类型强制为string，哪怕数据库是 bigint，对外暴露也转成字符串（如"ord_7b3f9a"） -
Timestamp固定用time.Now().UTC().Format(time.RFC3339)，别存 Unix 时间戳（易时区混淆） -
Result字段必须区分"success"、"failed"、"blocked"，失败时补ErrorCode（如"auth_failed"）而非笼统"error"
最常被忽略的是字段生命周期 —— audit.Event 一旦构造完成，所有字段应 immutable，后续中间件或 hook 不得 mutate，否则并发写入时结构体状态错乱。
