代码术语:blk

一文讲清楚:blk

先说结论:blk 不是一个含义固定的词,它只是 block 或 blacklist / blocklist 的缩写,具体意思完全取决于它出现在哪一层。而在 JWT 这个语境里更要先说清一件事:JWT / JOSE 规范里根本没有 blk 这个字段 —— 你看到的 blk,要么是自己系统里的私有命名(黑名单机制、自定义声明),要么干脆是 kid、jti 看错了。

语境 blk 指什么 例子
通用代码 block:块、代码块、数据块 分块读取、blk = buffer.slice(0, 512)
安全 / 鉴权 blacklist / blocklist:黑名单 令牌黑名单、IP 黑名单(现多写作 blocklist / denylist)
Linux 内核 / 系统 块设备层 blk_ 系列符号、blk-mq、/sys/block、命令 blkid
磁盘与文件系统 块数 ls -s、du 输出里的 blocks
二进制 / 文件格式 以块为单位的数据文件 区块链的 blk00000.dat
前端 / 排版 block:块级元素 display: block(与 inline 相对)

一句话:看到 blk 先看它所在的层 —— 系统层多半是「块」,安全层多半是「黑名单」,鉴权层则几乎一定和「撤销 / 拒绝」有关。

JWT 的标准字段是很短的封闭清单:

  • 标准 claim(RFC 7519):iss、sub、aud、exp、nbf、iat、jti
  • 标准 header(RFC 7515):alg、kid、jku、jwk、typ、cty、crit、x5u、x5c、x5t、x5t#S256

两张清单里都没有 blk。所以「JWT 的 blk」只可能是下面四种情况之一:

情况 说明 怎么判断
① 令牌黑名单的变量名 / 存储键 表示已被撤销的令牌,常写作 Redis 键 blk:<jti> 或变量 blkList 只出现在服务端代码、Redis、日志里,令牌本体没有
② 自定义 header / claim 业务自己塞进令牌的私有字段 解开令牌能解出来,但没有任何标准库会替你校验
③ 形近字段看错 kid(密钥 ID,常放公钥指纹)、jti(令牌唯一 ID) 令牌里实际写的是 kid 或 jti
④ 与 JWT 无关 同一段代码 / 日志里恰好有 blk 解出来完全没有它

JWT 的三段都是 base64url,明文可读,解出来一看就知道:

TOKEN='eyJ...'
# 打印 header 与 payload
node -e "for (const i of [0,1]) console.log(Buffer.from(process.argv[1].split('.')[i],'base64url').toString())" "$TOKEN"
  • 解出来的 JSON 里有 blk → 情况 ②,是自定义字段
  • 解出来只有 kid / jti、没有 blk → 情况 ③,看错了
  • 令牌里根本没有 blk → 情况 ① 或 ④,去服务端代码里搜 blk 才找得到

这是 JWT 场景下 blk 最可能的含义。

JWT 是无状态的:签发之后只要还没到 exp,验签通过就能用,服务端说不了「不」。想「立刻踢下线」,就必须额外记一份黑名单:

  • 撤销时把该令牌的 jti 写入 Redis(键如 blk:<jti>),TTL 设为 exp − now
  • 令牌没有 jti 时,退而求其次存整串令牌的哈希(不要存原文,防泄库;见 digest)
  • 服务端校验顺序变成:验签 → 查 exp / nbf → 查 iss / aud → 查黑名单 → 注入身份
  • 黑名单键必须设「到 exp 就自动消失」的过期时间,否则它会无限膨胀

代价与替代方案:

做法 效果 代价
短 access + 可撤销 refresh 撤销只作用于 refresh,access 等它自然过期 有几到十几分钟的「踢不干净」窗口,最常用
黑名单(jti) 能精确撤销单个令牌 JWT 重新变成有状态,每次请求多一次查询
令牌版本号 tokenVersion 改一个值即全端下线 每次请求要读一次用户信息(可缓存)
会话表 sid 支持「查看登录设备」逐台踢 已接近 Session 方案
结论:**黑名单是「用状态换即时性」的补救手段**,不是 JWT 的常规配置。能用「短 access + refresh 轮换」解决,就别急着上黑名单;更多撤销方案见 [[jwt|JWT]] 页面的「撤销:JWT 的固有短板」一节。

如果是你们自己的令牌里带了 blk,那它就是一枚私有字段,规则只有三条:

  • 语义由你们自己定义:规范不管、库也不认。跨系统对接时建议加命名空间(如 https://example.com/blk)避免撞名
  • 必须自己校验:签名只保证「内容没被改过」,不保证「值合理」。漏掉业务校验,等于把开关交给客户端
  • payload 是明文:只是 base64url 编码,不是加密,别放密钥、手机号等敏感值(见 payload)

常见的塞法是把「黑名单版本号」写进声明(如 blk: 7),用户表里存当前版本,对不上就拒绝 —— 这就是上面表格里的令牌版本号方案。

名字 是什么 出现在哪
kid 密钥 ID,实践里常直接放公钥指纹 JWS / JWE 的 header、JWK
jti 令牌唯一 ID,黑名单与日志追踪用它 JWT payload(claim)
blk(安全语境) blacklist / blocklist 黑名单 服务端代码、Redis、日志
blk(系统语境) block 块、块设备 内核符号、磁盘工具
kid 与指纹的关系 kid 是字段,指纹是它最常见的一种取值方式 详见 FP
现象 原因 处理方向
以为令牌里有个标准 blk 声明 规范里并没有这个字段 先解令牌确认位置,再判断是私有 claim 还是代码变量
黑名单越存越大 没按 exp 设 TTL,键永不过期 写入时就把 TTL 对齐 exp
把令牌原文存进黑名单 泄库即等于泄露可用令牌 只存 jti 或令牌哈希
以为 JWT 天生能即时失效 无状态,签发后无法撤回 接受短 access 的窗口,或引入黑名单 / 版本号
客户端能自己改 blk 就影响鉴权 服务端没校验,直接信了声明 私有 claim 一律服务端校验,不信任输入
黑名单查询放在验签之前 未验签的内容不可信,可被构造利用 顺序固定:验签 → 时效 → 受众 → 黑名单
''blk'' 就是 ''block'' 或 ''blacklist / blocklist'' 的缩写;**JWT 规范里没有这个字段**,所以「JWT 的 blk」通常指「令牌黑名单」这套撤销机制(键名、变量名、日志里的缩写),或者你们自己加的私有 claim。用它之前先解令牌确认位置,再按「用状态换即时失效」的代价权衡是否值得。

相关:JWT · FP(指纹) · payload · digest(摘要)


返回:代码术语

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/blk.1791883310.txt.gz
  • 最后更改: 2026/10/13 17:21
  • 由 张叶安