Buffalo 的 middleware.Logger 在 production 环境默认不生效,因其源码硬编码仅在 "development" 环境执行;需显式判断环境注册,注意中间件顺序、自定义日志需重写并处理 request_id/IP、输出目标可替换为文件或ELK,且 panic 日志须单独用 recover 中间件捕获。

middleware.Logger 在 production 下为什么没日志
因为 Buffalo 的 middleware.Logger 源码里硬编码了环境判断:if app.Options.Env != "development" { return next }。即使你在 app.Use(middleware.Logger) 里注册了,生产环境也会直接跳过,不执行任何日志逻辑。
验证方式:在 app.go 的 actions.App() 函数开头加一行 log.Printf("env: %s", app.Options.Env),确认值确实是 "production"。
必须显式加环境判断:
if app.Options.Env == "production" { app.Use(middleware.Logger) }- 注册位置要早于所有可能提前返回的中间件(如
auth.Required、cors.Default()),否则未认证请求根本进不到 Logger - 别放在
app.AutomaticResourceRouting()之后,否则/assets/这类静态资源请求不会被记录
怎么让日志带上 request_id 和真实 IP
middleware.Logger 字段是硬编码的,不支持配置。想加 X-Request-ID 或客户端真实 IP(而非 127.0.0.1),只能自己重写中间件。
核心动作是包装 http.ResponseWriter 并监听 WriteHeader,同时从 c.Request() 提取信息:
- request_id:优先读
c.Request().Header.Get("X-Request-ID"),没有就用uuid.NewString()生成 - IP:用
c.Request().RemoteAddr是反向代理后的地址;若前端有 Nginx,需解析X-Forwarded-For并做白名单校验(比如只信10.0.0.0/8) - 别在中间件里调
c.Error()或c.Render(),否则会干扰原响应流程,导致双写 header panic
自定义 Logger 中间件必须注意的顺序和依赖
Buffalo 中间件链是严格顺序执行的,顺序错一位,日志就漏记或字段为空。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
关键依赖关系:
- 如果用了
gzip.Middleware,自定义 Logger 必须放在它之后——否则ResponseWriter已被 gzip 包装,拿不到原始字节数 - 如果用了
pop.Transaction(app.DB),Logger 要放在它之前,否则c.Value("tx")还没塞进去,你没法在日志里打事务 ID - 静态资源中间件(
middleware.Static)默认注册较早,若想记录/public/请求,Logger 得比它更靠前;否则请求被 Static 拦截后就不再往下走
日志输出目标怎么改到文件或 ELK
middleware.Logger 底层用的是 logrus.Logger,默认输出到 os.Stdout。替换时机必须在 app.Use() 之前,否则中间件已绑定默认 logger。
实操步骤:
- 新建一个
logrus.Logger实例:l := logrus.New() - 设置输出目标:
l.Out = os.File(先用 os.OpenFile 创建句柄)或l.SetOutput(io.MultiWriter(file, networkWriter)) - 选格式器:
l.SetFormatter(&logrus.JSONFormatter{})(注意:不是结构化日志本身,只是序列化形式) - 把自定义中间件里的
log变量指向这个新实例,而不是全局logrus.WithFields() - 线上禁用
logrus.DebugLevel,防止日志爆炸;InfoLevel足够记录请求生命周期
真正容易被忽略的是 panic 日志——middleware.Logger 完全不捕获 panic,而线上最需要结构化的恰恰是 panic 场景:堆栈、路径、参数、IP、时间戳缺一不可。这部分必须单独加 recover 中间件,且要确保它在整个链最外层。










