Revel 默认日志能力弱，仅输出 INFO 级控制台日志，无请求 ID、参数、堆栈；需手动配置级别、接管输出（如 lumberjack 轮转）、注入 requestID，并补全请求体、SQL、panic 堆栈等关键信息。
Revel 框架默认日志能力偏弱，不配额外配置就上线，等于把线上问题的“眼睛”主动蒙上——你看到的只有 INFO 级别启动信息和极简错误提示，连请求 ID、参数、堆栈都缺，排查超时或 500 错误基本靠猜。
Revel 默认日志输出在哪、级别怎么改
Revel 启动后默认把日志写到控制台（stdout），不落盘、不轮转、不带时间戳，且默认只输出 INFO 及以上。这意味着 DEBUG 日志全被丢弃，WARN 和 ERROR 虽然会打出来，但格式固定、无上下文、无调用栈。
- 修改日志级别：在
conf/app.conf中设置log.level = DEBUG或log.level = ERROR；注意该配置仅影响 Revel 自身日志（如路由匹配、拦截器执行），不影响业务代码中手动调用的revel.INFO等 - 日志输出目标不可直接配置为文件——Revel 1.x 的
log.output参数已被废弃，硬设log.output = "logs/app.log"不生效 - 真正起作用的是 Go 标准库
log的默认输出器，所以想改输出位置，得在app/init.go的init()函数里重置：log.SetOutput(os.Stdout)或指向文件句柄
如何让 Revel 日志支持文件写入与自动轮转
Revel 原生不带日志轮转能力，必须借助第三方包（如 lumberjack）手动接管日志输出流。否则生产环境跑几天，单个日志文件就几十 GB，tail -f 都卡死。
- 安装依赖：
go get gopkg.in/natefinch/lumberjack.v2 - 在
app/init.go的init()函数开头添加：import ( "log" "os" "gopkg.in/natefinch/lumberjack.v2" ) func init() { logWriter := &lumberjack.Logger{ Filename: "logs/revel.log", MaxSize: 100, // MB MaxBackups: 7, MaxAge: 28, // days Compress: true, } log.SetOutput(logWriter) } - ⚠️ 注意：此方式只接管了 Go
log默认输出（即revel.INFO/revel.ERROR等调用），不改变 Revel 内部AppLog、TraceLog的行为；若需统一，建议后续迁移到zerolog或zap+ Revel 的revel.AppLog.SetLogger()接口
怎样给每条 Revel 日志注入请求上下文（如 requestID）
Revel 提供了 revel.Interceptor 机制，但默认不生成或透传请求唯一标识。没有 requestID，多线程并发日志就混成一团，根本无法串联一次完整请求链路。
- 在
app/init.go注册一个前置拦截器：revel.Interceptors.Insert(&revel.Interceptor{ Name: "RequestIDInjector", Func: func(c *revel.Controller, fc []revel.Filter) revel.Result { id := revel.UUID() c.Request.Header.Set("X-Request-ID", id) revel.INFO.Printf("REQ[%s] %s %s", id, c.Request.Method, c.Request.URL.Path) return nil }, Phase: revel.BEFORE, }) - 更稳妥的做法是结合中间件式封装，在每个 Controller 方法开头手动提取：
c.Params.Get("request_id")，前提是反向代理（如 Nginx）已注入该头；否则仍需在拦截器里生成并存入c.RenderArgs["request_id"]供模板使用 - ⚠️ 切勿在日志字符串里拼接
c.Request.RemoteAddr或c.Request.UserAgent—— 这些字段可能含非法字符或超长内容，导致 JSON 解析失败或日志截断
生产排错时 Revel 日志最常漏掉的三类关键信息
线上故障复盘发现，80% 的 Revel 日志缺失不是因为没打，而是打了但没打对位置、没带必要字段、或被框架吞掉。
- HTTP 请求体（
c.Params.JSON或c.Params.Form）从不自动记录——必须显式调用revel.DEBUG.Printf("req body: %+v", c.Params.JSON)，且建议只在DEBUG级别开启，避免敏感数据落盘 - 数据库 SQL 语句和耗时完全不记录——Revel 不集成 ORM，哪怕你用
gorm或sqlx，也得自己加钩子（如gorm.Config.Logger）或包装DB.Query方法 - 未捕获 panic 的堆栈默认不打印全——Revel 的
panic恢复机制只输出简短消息，要看到完整堆栈，需在app/interceptors.go里重写revel.PanicFilter，用debug.PrintStack()输出到自定义日志文件
真正的生产级日志不是“能记下来”，而是“能还原现场”。Revel 的轻量设计决定了它不会替你做决定，所有上下文、结构化、安全脱敏，都得你自己补全——漏掉任意一环，线上出事时翻日志就是在大海捞针。
