Iris 生成 JWT 需用 github.com/golang-jwt/jwt/v5,构造 jwt.RegisteredClaims 并用安全密钥签名;校验需自定义中间件解析 Bearer Token、验证签名与时效,并将 user_id 存入 ctx.Values() 供后续使用。

怎么用 Iris 生成 JWT 令牌?
Iris 本身不内置 JWT 生成逻辑,得靠第三方库,最常用的是 github.com/golang-jwt/jwt/v5(v5 是当前主流,别用已弃用的 jwt-go v3/v4)。生成令牌的关键是构造 jwt.RegisteredClaims 并签名。
- 必须用安全的密钥:推荐 32 字节以上随机密钥,存在环境变量或配置文件里,绝不能硬编码在代码中
- 签发时间(
IssuedAt)、过期时间(ExpiresAt)必须显式设置,否则令牌可能永不过期或立即失效 - 用户标识建议用
Subject字段(如用户 ID),别塞进自定义字段里,方便后续中间件统一解析
token := jwt.NewWithClaims(jwt.SigningMethodHS256, jwt.RegisteredClaims{
Subject: "12345", // 用户唯一标识
IssuedAt: jwt.NewNumericDate(time.Now()),
ExpiresAt: jwt.NewNumericDate(time.Now().Add(24 * time.Hour)),
})
signedToken, err := token.SignedString([]byte(os.Getenv("JWT_SECRET")))
if err != nil {
// 返回 500 或具体错误
}
Iris 中如何校验 JWT 并提取用户信息?
Iris 没有开箱即用的 JWT 中间件,但可以用 app.Use() + 自定义 handler 实现。核心是解析 Authorization Header 中的 Bearer Token,验证签名和时效,并把解析出的 Subject(或其他关键字段)存入 ctx.Values() 供后续 handler 使用。
- Header 格式必须严格匹配
Authorization: Bearer,空格不能少,大小写敏感 - 解析失败时(如签名错、过期、格式非法),应统一返回
401 Unauthorized,不要泄露具体失败原因(比如不区分“过期”和“签名无效”) - 验证通过后,建议只存必要字段(如
user_id),避免把整个 claims 塞进 context 增加内存开销
authMiddleware := func(ctx iris.Context) {
authHeader := ctx.GetHeader("Authorization")
if authHeader == "" || !strings.HasPrefix(authHeader, "Bearer ") {
ctx.StatusCode(iris.StatusUnauthorized)
ctx.JSON(iris.Map{"error": "missing or malformed authorization header"})
return
}
<pre class="brush:php;toolbar:false;">tokenStr := strings.TrimPrefix(authHeader, "Bearer ")
token, err := jwt.ParseWithClaims(tokenStr, &jwt.RegisteredClaims{}, func(t *jwt.Token) (interface{}, error) {
return []byte(os.Getenv("JWT_SECRET")), nil
})
if err != nil || !token.Valid {
ctx.StatusCode(iris.StatusUnauthorized)
ctx.JSON(iris.Map{"error": "invalid or expired token"})
return
}
claims := token.Claims.(*jwt.RegisteredClaims)
ctx.Values().Set("user_id", claims.Subject) // 后续 handler 可用 ctx.Values().GetString("user_id")
ctx.Next()
}
app.Use(authMiddleware)
为什么用 jwt.RegisteredClaims 而不是 map[string]interface{}?
用结构体(如 jwt.RegisteredClaims)而非泛型 map,是为类型安全和可维护性:
编译期能检查字段名是否拼错(比如
ExperisAt这种 typo 会直接报错)IDE 能自动补全字段,减少查文档时间
后续扩展自定义字段时,可以嵌入结构体,比 map 嵌套更清晰
Iris 的
ctx.Values()是 interface{} 容器,存结构体没问题,但取值时仍需断言;而存字符串 ID 更轻量,也更常用-
如果需要加自定义字段(如
role),推荐新建一个结构体嵌入jwt.RegisteredClaims,而不是用 map 不要用
jwt.MapClaims,它本质是map[string]interface{},运行时 panic 风险高(比如取不存在的 key)
常见错误:Token 解析成功但 ctx.Values() 取不到 user_id?
这不是 JWT 解析问题,而是 Iris 的执行顺序陷阱:
ctx.Values()是请求生命周期内有效的键值对,但只在当前请求上下文中存在如果你在中间件里设置了
ctx.Values().Set("user_id", ...),但在某个 handler 里调用ctx.Next()后又试图读取——那是另一个 handler 的 context,值不会自动传递更常见的是:handler 函数没加
ctx.Next(),导致后续 handler 根本没执行,或者中间件没调用ctx.Next()就提前返回,后续逻辑被跳过确保中间件末尾调用
ctx.Next()(除非你明确要终止流程)在目标 handler 里用
ctx.Values().GetString("user_id")读取,不要在中间件里读自己刚 set 的值来“测试”如果跨多个中间件传递数据,确认它们都在同一条路由链上注册(
app.Use()vsapp.Get("/xxx").Handle(...)的作用域差异)
Iris 的 context 生命周期很短,值存进去就只是“这一路请求”的临时凭证,别指望它跨请求、跨 goroutine 或跨中间件链自动延续。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











