讲师中心 微信公众号
AI工具推荐 视频效率加速

Echo框架如何获取JWT用户信息

云墨吖_8096

云墨吖_8096

发布时间:2026-10-15 07:12:52

|

443人浏览过

|

来源于php中文网

原创

Echo框架中echo-jwt/v4解析JWT后将jwt.Token存入c.Get("user"),需断言为jwt.Token再取.Claims;若用自定义Claims结构体,须在配置中指定并实现Valid()方法。

echo框架如何获取jwt用户信息

echo-jwt/v4 解析后用户信息存在 c.Get("user") 里,直接断言即可

echo-jwt/v4 中间件验证通过后,会把解析好的 *jwt.Token 存进 Echo Context 的 "user" key(默认值),不是字符串、不是 map,是原始的 jwt.Token 指针。你不能直接用 c.Get("user").(map[string]interface{}),会 panic。

正确做法是类型断言成 *jwt.Token,再取 .Claims:

token := c.Get("user").(*jwt.Token)
claims := token.Claims.(jwt.MapClaims)
name := claims["name"].(string)
user_id := int64(claims["user_id"].(float64)) // 注意:JSON number 默认是 float64
  • 必须先确认 c.Get("user") != nil,否则断言失败 panic
  • 如果用了自定义 Claims 结构体(比如实现了 jwt.Claims 接口),就按对应结构体断言,别硬转 jwt.MapClaims
  • echo-jwt 不自动帮你做字段类型转换,exp/iat 等时间戳字段在 MapClaims 里仍是 float64,需手动转 int64

为什么 c.Get("user") 有时是 nil?常见拦截点漏了

最常踩的坑:你在未经过 echo-jwt 中间件的路由里调 c.Get("user"),比如 /login 或 /public 路由,此时 "user" 根本没被设置,返回 nil。

  • 检查路由是否被 echo-jwt 中间件包裹:用 Group() 隔离受保护路由,别全局 e.Use() 后又在登录接口里取 user
  • 确认请求带了合法 Authorization: Bearer <token> 头;缺头、格式错(比如写成 Token xxx)、或用了错误 AuthScheme 都会导致中间件跳过赋值
  • 若配置了 JWTConfig.TokenLookup = "query:token",但请求走的是 header,那也取不到 —— 中间件根本不会触发解析
  • 签名或过期校验失败时,echo-jwt 直接返回 401,不会执行后续 handler,自然也没机会访问 c.Get("user")

jwt.MapClaims 取字段前务必做类型检查,别信文档里的“一定存在”

JWT payload 是客户端可控的,name、user_id 这些字段可能缺失、类型错(比如传字符串代替数字)、甚至为空。直接 claims["xxx"].(string) 在生产环境极易 panic。

Echo框架 5.1.0
Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

安全写法是逐层判断:

if name, ok := claims["name"].(string); ok && name != "" {
    // 安全使用 name
} else {
    return echo.NewHTTPError(http.StatusUnauthorized, "missing or invalid name claim")
}
  • 所有业务关键字段(如 user_id、role)都应显式检查存在性和类型
  • 数值型字段(user_id, exp)先 float64 断言,再转 int64,并检查是否为整数(math.Floor(v) == v)
  • 避免用 claims["exp"] != nil 判断过期 —— echo-jwt 已在校验阶段处理了 exp,这里只管业务字段

想用结构体绑定?得配 JWTConfig.Claims 并实现 Valid()

如果你希望直接绑定到自定义结构体(比如 type UserClaims struct { UserID uint `json:"user_id"` Role string `json:"role"` Exp int64 `json:"exp"` }),不能只靠 MapClaims 强转。

必须在 echo-jwt 配置里指定 Claims 字段,并让结构体实现 Valid() 方法(否则 echo-jwt 会跳过时间校验):

config := middleware.JWTConfig{
    SigningKey: []byte("secret"),
    Claims:     &UserClaims{}, // 注意:是指针
}
e.Use(middleware.JWTWithConfig(config))
  • Claims 必须是指针类型,否则运行时报 reflect.SetMapIndex: value of type ... is not assignable to type map[string]interface{}
  • UserClaims 必须嵌入 jwt.StandardClaims 或自行实现全部 Valid() 逻辑,否则 exp/nbf 校验失效
  • 此时 c.Get("user").(*jwt.Token).Claims 就是 *UserClaims,可直接类型断言
实际取用户信息这件事,难点不在语法,而在于你是否清楚当前请求所处的中间件链位置、token 是否已成功解析、以及 payload 字段是否真的可信。别省掉类型检查,也别假设字段一定存在——JWT 是开放协议,不是内部约定。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

更多
剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

0

2026.10.14

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

0

2026.10.14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

0

2026.10.14

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

0

2026.10.14

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

0

2026.10.14

二狗PPT文档转PPT全教程
二狗PPT文档转PPT全教程

本专题讲解二狗PPT解析Word、PDF、Excel和PPT资料的方法,涵盖文件上传、内容提取、大纲整理、异常处理与转换后校对。

0

2026.10.14

讯飞绘文全功能使用教程
讯飞绘文全功能使用教程

本专题系统整理讯飞绘文官网入口、注册登录、工作台及内容创作流程,帮助用户熟悉常用功能,快速完成首篇图文内容。

0

2026.10.14

讯飞绘文AI写作与文案生成合集
讯飞绘文AI写作与文案生成合集

本专题聚焦讯飞绘文AI写作、提纲生成、文章改写和文案润色,覆盖从主题输入到成稿优化的关键操作与实用技巧。

0

2026.10.14

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

100

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Echo框架IP地址文档
Echo框架IP地址文档

共0课时 | 0人学习

Echo框架中文安装文档
Echo框架中文安装文档

共0课时 | 0人学习

Echo框架快速入门指南
Echo框架快速入门指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn