使用说明与限制
怎样解析一枚 JWT?
- 粘贴完整的三段式令牌,格式为
Header.Payload.Signature。如果来自请求头,请先去掉Bearer前缀,不要一并粘贴引号。 - 点击“处理”;没有测试数据时,可先点击“加载示例”。示例签名是演示数据,不是可用于登录的凭据。
- 在结果中查看 Header、Payload 和时间解释;需要排查接口时,可以复制结果或下载 JSON,但应先删除账号、手机号等敏感声明。
结果中的字段分别代表什么?
- header / payload
- 分别是令牌声明的头部和载荷。
alg是声明使用的算法,sub、iss、aud常用于描述主体、签发者和受众;这些内容都可以被伪造,解析结果不是信任依据。 - utcTimes
- 把
iat(签发时间)、nbf(最早生效时间)、exp(过期时间)按 Unix 秒转换为 UTC;末尾的Z表示 UTC,不是北京时间。北京时间需加 8 小时。 - expired / notYetActive
- 依据当前电脑时钟判断是否过期、是否尚未生效。
null表示没有可用于该判断的数字声明,而不是“验证通过”;系统时钟不准也会影响判断。 - signatureBytes
- 第三段解码后的字节数,不代表签名正确,也不代表安全强度。
时间字段示例
{"sub":"example-user","iat":1700000000,"exp":2000000000}其中 iat: 1700000000 对应 2023-11-14T22:13:20.000Z。不要把 JavaScript 毫秒时间戳直接填入 JWT 秒时间戳,否则会出现异常遥远的日期。
为什么解码成功仍不能信任令牌?
Base64URL 是编码,不是加密,任何人都能修改前两段。本工具不验证签名、密钥、签发者或受众,不应据此授予权限;真正的认证必须由可信服务端按预期算法校验。五段式 JWE 属于加密令牌,需要解密,不在本工具支持范围内。
文本长度上限为 1,048,576 个 UTF-16 编码单元,约相当于同数量的常见中英文字符;emoji 可能占两个或更多单元。支持文件导入的工具另有 1 MiB 文件大小上限,文件需为 UTF-8 编码。