应在中间件闭包内、next.ServeHTTP()前用time.Now()获取请求开始时间并存入context,日志放其后,避免影响WebSocket、合理采样,并置于中间件链最外层。

中间件里怎么正确获取请求开始时间
Buffalo 的中间件函数签名是 buffalo.MiddlewareFunc,它接收一个 buffalo.Handler 和返回一个新的 buffalo.Handler。关键点在于:你不能在中间件外层直接用 time.Now() 记录起始时间——那会发生在 handler 被注册时,而非每次请求时。
实操建议:
- 必须在闭包内部、调用
next.ServeHTTP()前调用time.Now() - 把
start时间存进c.Request().Context(),后续日志或审计逻辑才能安全读取(避免 goroutine 间变量竞争) - 别用
c.Set("start_time", ...),因为c.Set是 request-scoped,但某些中间件(如 gzip)可能提前写响应,导致 context 丢失
为什么 log.Println() 在中间件里容易漏掉耗时
常见错误是中间件里写了 log.Println("took", time.Since(start)),但没等 next.ServeHTTP() 执行完就输出了——这其实只记录了“进入中间件到调用 next 的开销”,不是整个请求耗时。
实操建议:
- 必须把日志语句放在
next.ServeHTTP()之后 - 如果 handler panic,
next.ServeHTTP()会中断,日志不执行;应配合defer+recover或使用 Buffalo 内置的buffalo.WrapHandler封装 - 生产环境别用
log.Println,改用结构化日志库(如zerolog),把duration_ms作为字段写入,方便采集分析
如何避免中间件影响 WebSocket 升级
如果你项目同时跑 HTTP API 和 WebSocket(比如 /ws),而耗时中间件被全局注册(app.Use(...)),它就会在 /ws 路由上执行——而任何对 ResponseWriter 的写操作(包括日志中间件调用 WriteHeader)都会破坏 WebSocket Upgrade 流程,导致浏览器静默失败。
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
实操建议:
- 用
app.Group()隔离路由:HTTP API 走带中间件的 group,WebSocket 单独挂 root 或无中间件 group - 或者在中间件里判断:
if strings.HasPrefix(c.Request().URL.Path, "/ws") { return next.ServeHTTP(...) },直接跳过 - 绝对不要在中间件里调
c.Status()、c.Render()或任何可能触发WriteHeader()的方法
耗时中间件要不要加采样控制
全量打请求耗时日志,在 QPS 过千时会导致 I/O 瓶颈和磁盘打满,尤其当每个请求都含 trace ID、user_id、path、status、duration 多字段时。
实操建议:
- 默认只记录 >500ms 的慢请求(
if d > 500 * time.Millisecond) - 对高频路径(如
/health、/metrics)直接跳过日志 - 用
atomic.Int64统计每秒请求数,动态调整采样率(比如当前 RPS >1000 时降为 1% 采样)
最易被忽略的是:中间件顺序。如果你把耗时记录放在 logger 中间件之前,而 logger 自身又依赖 DB 连接池,那测出来的“耗时”实际包含了数据库连接等待时间——这不是应用层真实处理耗时。务必把耗时中间件放在最外层(app.Use() 第一个),再叠其他中间件。










