在goframe框架中,自定义请求拦截处理的核心是注册中间件。通过调用 server.use() 方法将自定义函数挂载到服务实例上,即可在请求进入具体路由处理器之前执行拦截逻辑。该机制支持对请求上下文进行统一修改、鉴权或日志记录,且能利用 ctx.next() 控制后续流程的执行。

如何定义并注册一个基础中间件
定义中间件需要遵循特定的函数签名,接收 *ghttp.Request 参数。在函数内部,先执行前置逻辑,随后调用 Request.Next() 触发后续处理链,最后可执行后置逻辑。注册时只需将该函数作为参数传入 Server.Use() 即可生效。

package main
import (
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/net/ghttp"
)
var s = frame.G()
// AuthMiddleware 定义一个简单的认证中间件
func AuthMiddleware(r *ghttp.Request) {
// 1. 前置逻辑:检查请求头中的 Token
token := r.Header.Get("Token")
if token == "" {
r.Response.WriteJson(g.Map{
"code": 401,
"message": "Missing Token",
})
return // 中断后续流程
}
// 2. 执行后续处理器
r.Next()
// 3. 后置逻辑(可选)
// 例如记录请求耗时等
}
func main() {
// 注册中间件
s.Use(AuthMiddleware)
s.Group("/api", func(group *ghttp.RouterGroup) {
group.Middleware(ghttp.MiddlewareHandlerResponse)
group.POST("/login", func(r *ghttp.Request) {
r.Response.WriteJson(g.Map{
"code": 200,
"message": "Login Success",
})
})
})
s.Run()
}
上述代码定义了 AuthMiddleware,并在 main 函数中通过 s.Use(AuthMiddleware) 将其注册到全局服务实例。当请求到达 /api/login 时,若未携带 Token 请求头,中间件直接返回 401 错误并终止请求;否则调用 r.Next() 继续执行路由处理器。
如何在中间件中传递数据给下游处理器
中间件与下游处理器共享同一个 *ghttp.Request 对象及其关联的上下文。因此,可以在中间件中通过 Context.Set() 方法存储任意数据,下游处理器则通过 Context.Get() 读取这些数据。这种方式常用于传递用户信息、权限标识或计算结果。

package main
import (
"context"
"github.com/gogf/gf/v2/frame"
"github.com/gogf/gf/v2/net/ghttp"
)
var s = frame.G()
const ctxKeyUserID = "userID"
// UserContextMiddleware 解析 Token 并将用户 ID 存入上下文
func UserContextMiddleware(r *ghttp.Request) {
token := r.Header.Get("Token")
// 模拟从 Token 解析出 UserID
var userID int64
if token == "valid-token" {
userID = 1001
} else {
userID = 0
}
// 将 UserID 存入上下文
r.Context = context.WithValue(r.Context, ctxKeyUserID, userID)
r.Next()
}
func main() {
s.Use(UserContextMiddleware)
s.GET("/user/info", func(r *ghttp.Request) {
// 从上下文中获取 UserID
userID := r.Get(ctxKeyUserID).Int64()
r.Response.WriteJson(g.Map{
"code": 200,
"userID": userID,
})
})
s.Run()
}
在 UserContextMiddleware 中,我们模拟了从 Token 解析用户 ID 的过程,并使用 context.WithValue 将 userID 存入请求上下文。下游处理器 /user/info 通过 r.Get(ctxKeyUserID) 成功获取该值。这种基于上下文的传参方式避免了使用全局变量,保证了并发安全。
如果 Token 验证失败,中间件如何正确中断请求
当 Token 验证失败时,中间件必须显式调用 r.Response.Write... 系列方法输出响应内容,并立即 return,不调用 r.Next()。这样 GoFrame 会识别到响应已写入,从而跳过后续的路由匹配和处理器执行,确保非法请求不会触及业务逻辑。











