必须先注册全局中间件再调用s.Run(),否则不生效;中间件按注册顺序执行,且每个中间件必须显式调用r.Middleware.Next()才能继续传递请求。

要在GoFrame项目中让所有HTTP请求都经过日志记录、权限校验或耗时统计等统一处理逻辑,必须正确注册全局中间件,否则这些逻辑不会自动生效。
理解中间件的执行时机
GoFrame中间件不是在路由注册时运行,而是在每次HTTP请求到达时按注册顺序逐个执行。s.Use()调用只是把函数指针存入中间件链表,真正执行要等到s.Run()启动服务后有真实请求进来。如果在s.Run()之后调用s.Use(),该中间件将完全不生效。
所有包的init()函数执行完毕、main()函数开始运行后,才进入Server配置阶段。此时必须先完成中间件注册,再调用s.Run(),顺序不可颠倒。
注册全局中间件
方法一:使用s.Use()注册单个中间件
在main()函数中获取Server实例后,直接调用s.Use()传入中间件函数:
s := g.Server()
s.Use(LoggingMiddleware)
s.Use(AuthMiddleware)
s.Run()
注意:s.Use()可连续调用多次,中间件按调用顺序从前到后执行;每个中间件内部必须显式调用r.Middleware.Next()才能继续向后传递请求,否则链路中断。
方法二:批量注册多个中间件
将多个中间件函数作为参数一次性传入s.Use():
s := g.Server()
s.Use(LoggingMiddleware, AuthMiddleware, PrometheusMiddleware)
s.Run()
这种写法等价于连续调用三次s.Use(),但更简洁。中间件执行顺序仍按参数从左到右排列。
编写一个标准日志中间件
第一步:定义中间件函数,接收*ghttp.Request指针
func LoggingMiddleware(r *ghttp.Request) {
第二步:记录请求基础信息
g.Log().Info(r.Context(), "Method:", r.Method, "URL:", r.URL.String(), "IP:", r.GetClientIp())
第三步:调用Next()放行请求,否则后续中间件和控制器都不会执行
r.Middleware.Next()
第四步:记录响应完成时间(此时响应体已生成但尚未写出)
g.Log().Info(r.Context(), "Status:", r.Response.Status, "Cost:", r.GetCostTime(), "ms")
}
【r.Middleware.Next()必须被调用,否则请求生命周期在此终止,控制器永远不会收到请求】
避免中间件注册常见错误
① 在s.Run()之后调用s.Use() —— 该中间件永远不会被触发
② 中间件函数内忘记调用r.Middleware.Next() —— 请求卡死,客户端永久等待
③ 将中间件函数名写错或未导入包 —— 编译通过但运行时报nil pointer panic
④ 使用匿名函数注册时捕获了外部变量导致闭包污染 —— 多个请求共享同一变量实例,引发数据错乱
s.Use(func(r *ghttp.Request) {
// 错误:这里引用了循环变量i,所有中间件实际共用最后一个i值
fmt.Println("middleware", i)
r.Middleware.Next()
})











