revel框架不内置用户操作日志功能，需在控制器层显式埋点、前端sendbeacon上报或中间件记录元信息；必须包含user_id、action、target_id、ip等可回溯字段，禁用敏感明文，推荐json格式与异步落库。
Revel 框架本身不提供开箱即用的「用户操作日志」（如“张三在 /book/123 点击了借阅按钮”），它只负责服务端请求/响应生命周期的日志（TRACE/INFO/WARN/ERROR）。要记录用户行为，必须在控制器层显式埋点，或结合前端事件上报 + 后端接收落地。直接依赖 app.conf 里的日志配置是无效的。
在 Revel 控制器里手动记录操作日志
这是最直接、可控性最强的方式：在关键业务动作的 handler 中调用 c.Log.Info 或自定义 logger 写入结构化日志。
- 不要只记 “用户点了按钮”，必须包含可回溯字段：
user_id（从 session 或 token 解析）、action（如"borrow"）、target_id（如图书 ID）、ip（c.Request.RemoteAddr）、referer - 避免在日志中拼接敏感值——例如密码、身份证号、token 原文；若需记录，应脱敏（如
***1234）或仅存哈希摘要 - 日志内容建议用 JSON 格式输出（而非自由文本），方便后续用 ELK 或 Loki 解析：
{"time":"2026-10-16T15:35:00Z","user_id":1024,"action":"borrow","book_id":889,"ip":"192.168.1.5"} - 注意性能：不要在高频接口（如搜索建议、心跳）里写同步磁盘日志；可考虑异步 channel + worker 落库，或先写入内存 buffer 再批量刷盘
配合前端 sendBeacon 上报 + Revel 接收 endpoint
适合记录点击、表单提交、页面停留等前端主动行为，与服务端业务逻辑解耦。
- 前端用
navigator.sendBeacon('/log/action', JSON.stringify(data))上报，确保页面关闭前也能发出 - Revel 需新增一个 controller 方法接收该请求，例如：
func(c App)LogAction()，路由配为POST /log/action - 后端接收时务必校验
Content-Type: application/json，并限制 body 大小（如c.Params.MaxSize = 4096），防止恶意膨胀 - 不建议直接把原始
sendBeacon数据落文件——易被伪造；至少校验 referer 或加简单签名（如 timestamp + hmac(secret, url+ts)）
用 Revel 中间件统一拦截并记录请求元信息
适合记录所有请求的粗粒度操作日志（如 “谁在什么时间访问了哪个路由”），但无法捕获具体按钮点击等细粒度行为。
- 中间件里可获取
c.Request.URL.Path、c.Request.Method、c.Request.Header.Get("User-Agent")、c.Request.RemoteAddr - 若需关联用户，必须依赖 session 或 JWT 解析；Revel 默认 session 存于加密 cookie，可用
c.Session.Get("user_id")获取 - 注意中间件执行顺序：它在路由匹配之后、controller 执行之前运行，因此拿不到 controller 内部的业务参数（如借阅哪本书），只能记录“访问了 /borrow/:id”这类路径模板
- 避免在中间件里做耗时操作（如写磁盘、远程调用），否则会拖慢所有请求；推荐写入本地 ring buffer 或发到本地 UDP 日志收集器（如 fluent-bit）
真正难的不是“怎么记”，而是“记哪些才不会漏关键线索又不至于淹没有效信息”。比如借阅失败，只记 "borrow failed" 毫无价值，但加上 err.Error()、book_stock、user_balance 这几个字段，排查效率能提升十倍。这些字段得从 controller 业务流里自然带出来，而不是靠日志系统硬凑。
