审计日志必须带完整上下文、定义明确事件类型、保障写入可靠性。需通过context.Context传递user_id等字段，用自定义auditKey避免冲突；敏感操作须显式标记为预设事件类型并校验字段；日志写入采用内存buffer+落盘暂存+指数退避重试机制；核心字段强制存在，扩展字段限于扁平key-value。
审计日志必须带上下文，否则无法定位操作源头
没上下文的 AuditLog 就是废日志。用户在哪个服务、哪个 API、哪个 goroutine、哪个数据库事务里执行了敏感操作？漏掉任意一项，出问题时就得靠猜。
Go 里最可靠的方式是把审计信息塞进 context.Context，并在入口（如 HTTP handler）注入初始字段：user_id、request_id、ip、endpoint。后续所有审计记录都从 context 提取，而不是靠函数参数层层透传。
- 用
context.WithValue()注入时，键必须是自定义类型（避免字符串冲突），比如type auditKey struct{} - HTTP 中间件里统一提取
X-Forwarded-For和Authorization，解析出user_id后存入 context - 不要在 goroutine 里直接用
context.Background()发审计日志——它没上下文，会丢关键字段
敏感操作必须显式标记，不能靠日志级别或关键词过滤
靠 "delete" 或 "admin" 这类字符串做敏感判断，迟早漏报或误报。Go 模块里应该定义明确的审计事件类型，比如 AuditEventUserDelete、AuditEventConfigUpdate，每个类型对应一个结构体和预设的字段集。
实际调用时，不是写 log.Info("user deleted")，而是调用专用方法：audit.Log(ctx, AuditEventUserDelete, map[string]interface{}{"user_id": 123, "reason": "violation"})。
立即学习“go语言免费学习笔记（深入）”；
- 事件类型要提前注册到审计模块，确保字段校验、脱敏规则、存储策略可按类型差异化配置
- 禁止在事件 payload 里传原始密码、token、私钥——模块内部应强制检查并 panic 或丢弃（开发期就暴露问题）
- 如果操作涉及多条 DB 记录（如批量删除），审计日志必须带
affected_count字段，不能只记“成功”
日志写入不能阻塞主流程，但也不能丢
同步写文件或发 HTTP 到审计中心，一旦下游抖动，整个业务请求就卡住。异步队列又怕进程崩溃时内存里还没 flush 的日志丢失。
稳妥做法是：内存 buffer + 落盘暂存 + 后台 goroutine 重试。用 chan 做缓冲队列（容量 1000），满时降级为同步写本地 JSONL 文件（路径如 /var/log/audit/buffer_20240521.jsonl），后台 goroutine 定期读取并重发。
- buffer channel 用
select带 timeout 写入，超时就走降级路径，避免主流程 hang - 本地文件按天分片，用
os.O_APPEND | os.O_CREATE打开，不加锁（单 writer） - 重试逻辑必须带指数退避和最大重试次数（比如 5 次，间隔 1s→2s→4s…），失败后保留文件不清理，人工介入
审计日志字段必须可扩展，但核心字段不能缺失
上线后总有人提新字段需求：租户 ID、操作来源 App、设备指纹……硬编码结构体撑不了三个月。但也不能全用 map[string]interface{}，那样查日志、建索引、做字段校验全乱套。
折中方案是定义基础结构体，嵌入可选扩展字段：type AuditLog struct { Timestamp time.Time `json:"ts"`; EventType string `json:"event"`; ...; Extensions map[string]string `json:"ext,omitempty"` }。核心字段（时间、事件类型、用户、IP、结果）强制存在；扩展字段仅用于临时适配，不参与索引或告警。
-
Extensions里禁止存二进制、长文本、嵌套 JSON——只接受扁平 key-value，且 key 必须小写字母+下划线 - 所有字段序列化前走一次
json.Marshal预检，捕获json.UnsupportedTypeError并 panic（开发期暴露非法类型） - 如果审计系统支持 OpenTelemetry，优先用
otel.SetSpanAttribute补充 span 层面的审计元数据，而非重复打日志
真正难的不是记下操作，而是让每一条日志都能在三个月后被快速关联到具体人、具体请求、具体代码行。字段设计、上下文传递、写入可靠性，三者缺一不可——少做一步，审计就变成摆设。
