Beego中应通过Filter机制在FinishFilter和panic捕获阶段统一记录审计日志，内容含user_id（从session/JWT可信提取）、request_path、method、status_code、cost_ms、client_ip；日志须结构化输出至Fluent Bit/Filebeat或SIEM系统，禁用本地beego.log；需单独配置auditLogger实例并规范字段命名。
Beego 中如何记录用户行为审计日志
直接在 Controller 方法里写日志语句不是不行，但容易遗漏、格式不统一、缺乏上下文（如用户 ID、请求路径、耗时），也难和权限校验、异常捕获联动。真正可落地的审计日志，得从 Beego 的 Filter 机制切入，把记录动作前置到请求生命周期入口。
推荐做法是定义一个全局 Filter，在 FinishFilter 阶段统一记录成功请求，在 RecoveryFilter 或自定义 panic 捕获逻辑中补全失败请求。这样能确保每个 HTTP 请求都有且仅有一条审计日志条目。
- 日志内容至少包含：
user_id（从 session 或 token 解析）、request_path、method、status_code、cost_ms、client_ip（用c.Ctx.Input.IP()获取，别用RemoteAddr） - 避免在业务逻辑里零散调用
beego.Info()：重复字段多、时间戳不一致、失败路径可能没日志 - 不要把敏感操作（如密码重置、权限变更）的日志内容全量打到审计日志里：脱敏处理应在写入前完成，例如只记“用户 A 执行了密码重置”，不记原始密码或 token 值
审计日志该写到哪里：文件 vs 第三方服务
Beego 默认日志输出到文件（logs/beego.log），但审计日志有特殊要求：不可篡改、可溯源、需长期保留、常被安全团队拉取分析。直接写本地文件不满足合规底线。
生产环境应跳过 beego.SetLogger 的默认 file adapter，改用支持异步写入、按字段结构化、带鉴权推送能力的方案：
- 轻量级：用
beego.SetLogger+ 自定义Adapter，将日志 JSON 化后发往 Fluent Bit / Filebeat 容器，再由其转发至 ELK 或 Loki - 强合规场景：对接企业已有的 SIEM 系统（如 Splunk、Microsoft Sentinel），通过 HTTP Event Collector 或 Syslog 协议直传，字段名需对齐对方 schema（例如
event_type: "user_action"、actor_id替代user_id） - 别用
console或connadapter 直连数据库：审计日志写入失败不能阻塞主业务，必须有本地缓冲和重试机制
如何关联用户身份与会话数据
审计日志里 user_id 字段不能靠前端传参或 URL 参数拼接——这是典型伪造点。必须从可信链路提取：登录态凭证（JWT / session）→ 解析 → 校验 → 提取唯一标识。
Beego 项目常见组合是 sessionx（Redis 存储） + JWT 中间件。关键动作在 Filter 初始化阶段：
- 先调用
c.GetSession("user_id")尝试从 session 取；若为空，再解析 Authorization Header 中的 JWT，用jwt.Parse验签并读取sub或uidclaim - 务必检查 session 是否过期、JWT 是否被撤销（查 Redis 黑名单或 DB 状态字段），否则会记录“已登出用户”的虚假操作
- 如果两种方式都失败，
user_id应记为"anonymous"，并额外标记auth_failed: true，这类请求本身就需要被审计关注
audit.log 文件命名与轮转策略
单独拆出 audit.log 是必要习惯，但 Beego 默认 logger 不支持按文件名分流。得手动创建独立 logger 实例：
在 main.go 初始化时：
auditLogger := beego.NewLogger()
auditLogger.SetLevel(beego.LevelInformational)
auditLogger.SetLogger("file", `{"filename":"logs/audit.log","maxlines":1000000,"maxsize":524288000,"daily":true,"maxdays":90}`)
beego.AddLogger("audit", auditLogger)
注意三个易错点：
-
maxsize单位是字节，524288000 = 500MB，设太小会导致频繁切文件，影响日志检索效率 -
daily:true和maxdays:90必须同时配，否则旧文件不会自动清理 - 别在 Controller 里用
beego.Info()写审计日志：它走的是默认 logger，会混进beego.log，失去隔离性
最麻烦的其实是日志字段一致性——同一操作在不同 Controller 里记录的 key 名（如 user_id vs uid vs account）稍有差异，后续做统计或告警就全乱了。定好命名规范并写进团队 Wiki，比写一百行代码还重要。
