在GoFrame中启用JWT鉴权需配置密钥、实现JWT服务、注册中间件、绑定路由并获取用户ID。密钥须32字节随机字符串,中间件解析Bearer Token并注入uid到上下文,登录接口不可绑定该中间件。

要在GoFrame框架中为API接口启用JWT鉴权,必须让中间件能拦截请求、解析Authorization头中的Bearer Token、验证签名与有效期,并将合法用户信息注入上下文供后续业务使用。
准备JWT密钥与配置项
在config/config.yaml中新增jwt配置块,确保secret为至少32字节的随机字符串,避免使用默认值或短字符串——否则HS256签名极易被暴力破解。
添加如下内容:
jwt: secret: "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6" ttl: 3600 issuer: "gf-app"
【secret必须全局唯一且禁止硬编码在代码里】,若后续切换为RSA非对称签名,此处需改为publicKey和privateKey路径。
定义JWT服务结构体
新建internal/service/jwt.go,声明JWTService结构体并实现CreateToken与ParseToken两个核心方法。
其中CreateToken需接收用户ID、用户名等必要字段,构造CustomClaims(嵌入jwt.StandardClaims),设置ExpiresAt、Issuer、Id三项必填字段。
调用jwt.NewWithClaims(jwt.SigningMethodHS256, claims)生成token对象后,用SignedString([]byte(secret))完成签名——这一步失败会直接panic,务必用err != nil包裹。
注册全局鉴权中间件
第一步:在internal/middleware/auth.go中定义函数JWTAuth(),返回ghttp.HandlerFunc类型。
第二步:从r.Request.Header.Get("Authorization")提取值,按空格分割,校验前缀是否为"Bearer";若不匹配,直接调用r.Response.WriteStatus(http.StatusUnauthorized)并return,不执行r.Middleware.Next()。
一款AI工具,主要用于Monitor and clean up invalid Codex authentication files in CPA. Check quota status, disable files returning 401 errors, and perform dual verification before deletion.,适合需要提升相关任务效率的用户。
第三步:调用service.JWTService.ParseToken(tokenStr)解析token。若返回err != nil,同样中断流程并返回401。
第四步:解析成功后,将claims.Id(即用户ID)写入r.Context().SetValue("uid", claims.Id),再执行r.Middleware.Next()放行请求。
绑定中间件到路由组
方法一:对需要鉴权的API分组统一绑定,在internal/router/api.go中找到v1 := s.Group("/api/v1"),在其后追加v1.Middleware(middleware.JWTAuth())。
方法二:对单个敏感路由精准控制,例如仅保护用户资料接口:s.BindHandler("GET:/api/v1/user/profile", middleware.JWTAuth(), handler.UserProfile)。
注意:登录接口/api/v1/auth/login绝不可绑定该中间件,否则形成死锁——没token进不来,进了又需要token。
在控制器中获取当前用户
在任意已绑定JWTAuth中间件的handler函数中,通过r.Context().GetValue("uid").(string)取出用户ID。
这一步必须做类型断言,因为GetValue返回interface{};若中间件未执行或key名拼错,此处会panic,建议先判空再断言。
获取到uid后,可直接用于查询数据库、校验权限、记录操作日志等后续逻辑。










