应使用ctx.Values().Set("start_time", time.Now())在中间件开头记录起始时间,并在ctx.OnSuccess()或ctx.OnFailure()回调中计算耗时,确保覆盖Abort、panic、Redirect及流式响应等所有路径,避免用defer或ctx.Next()后直接统计导致状态码未定或响应未写出。

中间件里怎么记录请求开始和结束时间
直接用 time.Now() 获取起始时间,响应写入前再取一次差值,这是最轻量的做法。Iris 的 Context 支持在生命周期内存取任意键值,推荐把开始时间存在 ctx.Values().Set("start_time", time.Now()) 里,避免闭包捕获或全局变量污染。
注意别用 ctx.SetUserValue() —— 它只在当前请求生命周期有效,但命名空间不隔离,多个中间件可能冲突;Values() 是专为这类元数据设计的。
- 必须在中间件开头就调用
time.Now(),不能延迟到 handler 执行后才记,否则漏掉路由匹配、中间件执行等耗时 - 不要用
defer包裹结束时间统计:Iris 的ctx.Next()返回后响应可能尚未写出(比如启用了压缩或流式响应),真正可靠的时机是ctx.ResponseWriter().Written()为 true 后,或更稳妥地——在ctx.OnSuccess()回调里 - 如果用了
ctx.Abort()提前终止(如鉴权失败),也要手动触发耗时记录,否则这部分请求会丢失指标
如何把耗时写入响应头或日志
常见需求是透传给前端做性能分析,或者打点到日志系统。Iris 允许在 OnSuccess 或 OnFailure 钩子中操作响应,这时响应体还没 flush,可以安全加 header。
示例:添加 X-Response-Time 头
ctx.OnSuccess(func(ctx iris.Context) {
start := ctx.Values().Get("start_time").(time.Time)
dur := time.Since(start).Microseconds()
ctx.Header("X-Response-Time", fmt.Sprintf("%dμs", dur))
})
- 单位选微秒(
Microseconds())比毫秒更精确,尤其对 sub-ms 级接口有意义 - 避免用
ctx.ResponseWriter().WriteHeader()后再写 header,会 panic;OnSuccess是安全边界 - 日志输出建议统一走结构化字段,例如
logger.Info("request finished", "path", ctx.Path(), "status", ctx.GetStatusCode(), "duration_us", dur),方便后续聚合分析
为什么用 ctx.OnSuccess() 而不是 ctx.Next() 后直接算
因为 ctx.Next() 执行完,handler 可能已返回,但 Iris 还没真正写出响应(比如启用了 Gzip、Streaming、或者你手动调了 ctx.StopExecution())。这时候读 ctx.GetStatusCode() 可能仍是 0,ctx.ResponseWriter().Written() 也可能是 false,导致耗时被错误归类为“失败”或漏统计。
OnSuccess 和 OnFailure 是 Iris 底层在 HTTP 写入完成、状态码确定后的最终回调,覆盖了所有分支:正常返回、panic 捕获、Abort()、甚至 ctx.Redirect()。
-
OnFailure里也能拿到准确耗时,适合单独打点异常慢请求(比如 >2s 的 500) - 这两个钩子是链式注册的,多次调用不会覆盖,适合模块化埋点(认证中间件记 auth 耗时,DB 中间件记 query 耗时)
- 不要在钩子里调
ctx.Next()或修改响应体,它们是只读上下文
生产环境要注意的三个细节
本地跑通不等于线上可用。真实流量下容易暴露几个隐性问题:
- 高并发时频繁调用
time.Now()有微小开销,但 Iris 默认每请求只调两次,可接受;若需极致性能,可用runtime.nanotime()替代(需转成time.Time时注意时区) - 日志打点若每请求都写磁盘,IO 会成为瓶颈;建议异步批量写入,或先写内存 ring buffer,定时刷出
- 如果启用了
iris.WithoutVersionChecker或自定义错误处理,要确认OnFailure是否仍被触发——某些 panic 恢复逻辑可能绕过它,此时得在 recover defer 里补一手统计
耗时统计本身不难,难的是在各种异常路径下都不丢数据。重点盯住 Abort、Redirect、Panic 和流式响应这四类场景,它们最容易漏掉计时。











