目录

一文讲清楚:blk

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

1. blk 的常见含义

语境 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 先看它所在的层 —— 系统层多半是「块」,安全层多半是「黑名单」,鉴权层则几乎一定和「撤销 / 拒绝」有关。

2. JWT 里的 blk:规范中没有

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

两张清单里都没有 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"

3. 用法一:黑名单(blocklist)做令牌撤销

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

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

代价与替代方案:

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

4. 用法二:自定义 claim / header 里的 blk

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

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

5. 易混淆对照

名字 是什么 出现在哪
kid 密钥 ID,实践里常直接放公钥指纹 JWS / JWE 的 header、JWK
jti 令牌唯一 ID,黑名单与日志追踪用它 JWT payload(claim)
blk(安全语境) blacklist / blocklist 黑名单 服务端代码、Redis、日志
blk(系统语境) block 块、块设备 内核符号、磁盘工具
kid 与指纹的关系 kid 是字段,指纹是它最常见的一种取值方式 详见 FP

6. 常见坑速查

现象 原因 处理方向
以为令牌里有个标准 blk 声明 规范里并没有这个字段 先解令牌确认位置,再判断是私有 claim 还是代码变量
黑名单越存越大 没按 exp 设 TTL,键永不过期 写入时就把 TTL 对齐 exp
把令牌原文存进黑名单 泄库即等于泄露可用令牌 只存 jti 或令牌哈希
以为 JWT 天生能即时失效 无状态,签发后无法撤回 接受短 access 的窗口,或引入黑名单 / 版本号
客户端能自己改 blk 就影响鉴权 服务端没校验,直接信了声明 私有 claim 一律服务端校验,不信任输入
黑名单查询放在验签之前 未验签的内容不可信,可被构造利用 顺序固定:验签 → 时效 → 受众 → 黑名单

7. 一句话总结

''blk'' 就是 ''block'' 或 ''blacklist / blocklist'' 的缩写;**JWT 规范里没有这个字段**,所以「JWT 的 blk」通常指「令牌黑名单」这套撤销机制(键名、变量名、日志里的缩写),或者你们自己加的私有 claim。用它之前先解令牌确认位置,再按「用状态换即时失效」的代价权衡是否值得。

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


返回:代码术语

# blk(JWT 里的 blk)

## 一句话
### block / blacklist 的缩写
### 语义取决于出现的语境
### JWT 规范里没有 blk 字段

## 常见含义
### 通用代码:block 块、代码块
### 安全:blacklist / blocklist 黑名单
### 内核:blk_ 符号、blk-mq、/sys/block
### 磁盘:ls -s / du 的 blocks 块数
### 文件格式:blk 数据块文件
### 前端:display: block

## JWT 里的四种可能
### ①令牌黑名单的变量名或 Redis 键
### ②自定义 header / claim
### ③形近字段看错:kid、jti
### ④与 JWT 无关,恰好同名

## 怎么确认
### base64url 解出 header 与 payload
### 令牌里有 → 私有字段
### 只有 kid / jti → 看错了
### 令牌里没有 → 去服务端代码搜

## 用法一:黑名单撤销
### 撤销时把 jti 写进 Redis
### 键如 blk:<jti>,TTL 对齐 exp
### 没有 jti 就存令牌哈希
### 校验顺序:验签 → 时效 → 受众 → 黑名单
### 代价:重新变成有状态,每次多查一次
### 替代:短 access + refresh 轮换

## 用法二:自定义 claim
### 语义自己定,跨系统加命名空间
### 必须自己校验,签名不保证值合理
### payload 明文,别放敏感值
### 常见:把黑名单版本号写进声明

## 易混淆
### kid:密钥 ID,常放公钥指纹
### jti:令牌唯一 ID,黑名单与日志用
### blk(安全):黑名单
### blk(系统):块、块设备
### kid 与指纹:字段 vs 取值方式

## 常见坑
### 以为有标准 blk 声明
### 黑名单不设 TTL 会无限膨胀
### 存令牌原文而非哈希
### 以为 JWT 能即时失效
### 客户端能改 blk 说明没校验
### 黑名单查询放在验签之前

## 记住这句
### JWT 里没有 blk 字段
### 多半指令牌黑名单机制
### 用状态换即时失效,先权衡