Agent Skills
返回列表
💻

JWT 令牌调试器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/decode-inspect-sign-and-verify-jwts-while-debugging-auth-flows-with-jwt-cli。

技能介绍

调试认证流程时，JWT 问题为何难定位

在调试认证流程时，JWT 出了问题往往很难快速定位。例如令牌无法通过验证、声明内容不符合预期，或者签名密钥不匹配，都可能让排查过程变得复杂。这些问题分散在解码、声明检查、签名和验证等多个环节，手动处理效率低且容易遗漏关键信息。

用 jwt-cli 完成核心操作

该技能围绕 jwt-cli 提供支持，核心能力包括：

  • 解码 JWT：直接解码令牌，查看其中的声明内容
  • 检查声明：快速定位 claims 中的关键信息，确认是否符合预期
  • 签名与验证：使用本地密钥对令牌进行签名或验证，排查签名不匹配的问题

操作时，可先解码目标 JWT 检查声明，若需要验证签名，再用本地密钥执行验证步骤；若需生成测试令牌，则使用本地密钥进行签名。

适用边界与注意点

  • 密钥格式要求：底层库 jsonwebtoken 不支持 SEC1 私钥格式，需先转换为 PKCS8 类型
  • 安装路径限制：需将工具安装在 $PATH 路径下（如 Linux/macOS 的 /usr/local/bin），Windows 系统无默认合适路径
  • 平台支持：仅提供 64 位 Linux、macOS、Windows 的预构建二进制，其他系统需从源码构建

使用场景

  • 登录功能异常时，解码服务端返回的 JWT，检查 claims 中的用户 ID、过期时间与权限声明是否符合预期
  • 本地联调认证接口，用本地密钥验证 JWT 签名是否匹配，排查验签失败是否由密钥不匹配引起
  • 为认证模块编写测试时，用本地密钥签名生成测试 JWT，验证服务端验签逻辑是否正确
  • 网关或第三方服务返回的令牌验签失败，解码 JWT 后比对声明与签名，定位问题出在哪一环

适合人员

  • 后端开发工程师，日常调试认证接口时需要快速解码和验证 JWT，定位登录或权限问题
  • 前端工程师，对接登录回调时需要检查收到的令牌声明，确认用户信息和权限字段是否正确
  • 测试工程师，为认证模块编写用例时需要生成带签名的测试 JWT，验证服务端验签逻辑
  • SRE 工程师，排查网关或第三方服务令牌验签失败时，需要解码 JWT 分析声明与签名