导语:Bcrypt 72字节限制自 1999 年算法诞生便已存在,但 2025 年 CVE-2025-22228 的披露与 Python bcrypt 5.0 的拒绝行为升级,正让大量存量系统突然抛出
ValueError或陷入认证绕过风险。本文从 Blowfish 密钥调度原理出发,横评主流语言库的截断与报错行为,给出字节级检测、预哈希加固与平滑迁移的工业级方案。
企业级安全规范
flowchart TD
subgraph 接入层 ["表现层与接入网关 (Client & Gateway Tier)"]
A["用户提交密码 (UTF-8 编码)"] --> B["安全拦截网关 (输入校验)"]
end
subgraph 规则层 ["规则编排与上下文层 (Policy & Context Tier)"]
B --> C{"字节长度 > 72?"}
C -->|"是"|
D["策略分支:截断/报错/预哈希"]
C -->|"否"|
E["直接进入哈希流程"]
end
subgraph 领域层 ["核心执行与改写引擎 (Core Rewriter Tier)"]
D --> F["Bcrypt 密钥调度 (Blowfish Key Setup)"]
E --> F
F --> G["哈希输出 (60 字符)"]
end
subgraph 存储层 ["基础设施与数据存储 (Infrastructure Tier)"]
G --> H[("持久化 DB / 用户凭证表")]
end
一、Bcrypt 72字节限制的根源:Blowfish 密钥调度
Bcrypt 基于 Blowfish 分组密码,其密钥调度算法(Key Setup)将密码作为密钥输入,而 Blowfish 的 P-array 与 S-box 初始化共需 18 个 32 位子密钥,合计 576 位即 72 字节。这一设计在 Provos 与 Mazières 的原始论文中已被固化,因此 Bcrypt 72字节限制 并非实现缺陷,而是算法基因。超过 72 字节的部分在哈希计算中会被静默丢弃,这意味着两个前 72 字节相同的密码将产生完全相同的哈希值——这正是认证绕过风险的温床。
1.1 字节 vs 字符:多字节编码的陷阱
限制以 UTF-8 字节数为准,而非字符数。一个中文字符占 3 字节,一个 emoji 占 4 字节,19 个 emoji 即达 76 字节,早已越界。更隐蔽的是 JavaScript 的 password.length 返回 UTF-16 码元数,19 个 emoji 返回 38,与真实字节数 76 相去甚远。开发者若按字符数校验,将留下巨大的安全缺口。
| 语言/环境 | 正确字节长度计算方式 | 常见错误 |
|---|---|---|
| JavaScript / Node.js | Buffer.byteLength(password, 'utf8') |
password.length (UTF-16 码元) |
| Python | len(password.encode('utf-8')) |
len(password) (字符数) |
| PHP | strlen($password) |
mb_strlen($password) (字符数) |
| Go | len([]byte(password)) |
len(password) (字节数,但 string 底层为字节,正确) |
二、CVE-2025-22228:Spring Security 认证绕过漏洞
2025 年披露的 CVE-2025-22228(CVSS 7.4)直指 Spring Security 的 BCryptPasswordEncoder.matches() 方法:当用户密码超过 72 字符时,只要前 72 字符匹配,该方法便返回 true。攻击者无需知晓完整密码,仅需提供正确的前 72 字节即可通过认证。受影响的版本已在补丁中改为抛出 IllegalArgumentException,但存量系统若未升级,则持续暴露于认证绕过风险中。
若你的 Spring Security 版本低于补丁版本,且允许用户设置超过 72 字节的密码,攻击者可通过构造前 72 字节相同的密码直接登录任意账户。请立即升级至官方修复版本,并在注册/改密环节强制 72 字节上限。
2.1 Okta 2024 事件:拼接哈希的致命错误
Okta 在 2024 年的安全公告中描述了一个类似场景:缓存键由 bcrypt(userId + username + password) 生成。当用户名长度达到 52 字符以上时,密码部分被推至 72 字节之后,导致缓存登录无需正确密码即可成功。Okta 随后切换至 PBKDF2。这一案例警示:绝不要将密码与其他字段拼接后再交给 Bcrypt,否则密码可能完全落在截断区之外。
三、主流语言库行为横评:静默截断 vs 拒绝报错
不同库对超长密码的处理策略存在代际差异,这是导致“昨天还能跑,今天突然崩”的根本原因。我们实测了以下库的行为:
| 库/语言 | 版本 | 超 72 字节行为 | 风险等级 |
|---|---|---|---|
| Node.js bcrypt | 6.0.0 | 静默忽略多余字节 | 低(但无感知) |
| Node.js bcryptjs | 3.0.3 | 静默忽略,提供 bcrypt.truncates() 检测 |
低 |
| PHP password_hash() | 8.0.30+ | 静默忽略 | 低 |
| Python bcrypt | 4.0.1 | 静默忽略 | 低 |
| Python bcrypt | 5.0.0 | 抛出 ValueError |
高(兼容性断裂) |
| passlib + bcrypt 5.0 | 1.7.4 | 所有密码均抛 ValueError(自检失败) |
严重 |
| Go x/crypto/bcrypt | 当前 | GenerateFromPassword 返回 ErrPasswordTooLong |
中(需处理错误) |
| Spring Security BCryptPasswordEncoder | 补丁前 | 静默截断,matches() 可绕过 |
高危(CVE-2025-22228) |
| Spring Security BCryptPasswordEncoder | 补丁后 | 抛出 IllegalArgumentException |
低 |
Python 生态中,passlib 已停止维护(最后版本 1.7.4 发布于 2020 年),其自检逻辑使用 255 字节测试密码,在 bcrypt 5.0 下必然失败,导致所有密码哈希操作抛出异常。若你的 FastAPI/Flask 项目仍在使用 passlib,升级 bcrypt 至 5.0 将直接导致认证服务不可用。
四、工业级加固方案:从检测到迁移
4.1 方案一:强制 72 字节上限(OWASP 推荐)
在注册与改密环节进行字节级校验,并给出用户友好的提示。这是最简单且符合 OWASP Password Storage Cheat Sheet 的方案。
function assertBcryptLength(password) {
if (Buffer.byteLength(password, 'utf8') > 72) {
throw new Error('密码长度不能超过 72 字节(约 72 个英文字符,或更少的中文/emoji)');
}
}
def check_length(password: str) -> None:
if len(password.encode("utf-8")) > 72:
raise ValueError("密码长度不能超过 72 字节(约 72 个英文字符,或更少的中文/emoji)")
4.2 方案二:预哈希 + 胡椒(Pepper)
若需支持任意长度密码,可先使用 HMAC-SHA384 与密钥(Pepper)对密码进行预哈希,再将 Base64 编码后的固定长度结果交给 Bcrypt。OWASP 推荐构造为 bcrypt(base64(hmac-sha384(password, pepper))),其中 Pepper 存储在数据库之外(环境变量或密钥管理服务)。
const crypto = require('crypto');
const bcrypt = require('bcrypt');
function prepare(password) {
return crypto.createHmac('sha384', process.env.PASSWORD_PEPPER)
.update(password, 'utf8')
.digest('base64');
}
const hash = await bcrypt.hash(prepare(password), 12);
const ok = await bcrypt.compare(prepare(password), hash);
import base64, hashlib, hmac, os
import bcrypt
PEPPER = os.environ["PASSWORD_PEPPER"].encode()
def prepare(password: str) -> bytes:
return base64.b64encode(
hmac.new(PEPPER, password.encode("utf-8"), hashlib.sha384).digest()
)
hashed = bcrypt.hashpw(prepare(password), bcrypt.gensalt(rounds=12))
ok = bcrypt.checkpw(prepare(password), hashed)
预哈希方案必须使用 HMAC 而非裸哈希,且 Pepper 必须与数据库分离存储。裸哈希输出可能包含空字节,某些 Bcrypt 实现会将其视为密码终止符,导致截断;同时裸哈希易受“密码脱壳”(password shucking)攻击。
4.3 方案三:迁移至 Argon2id
Argon2id 是 OWASP 当前首推的密码哈希算法,无 72 字节限制,且内存硬特性使其更抗 GPU 破解。FastAPI 官方教程已从 passlib 迁移至 pwdlib + Argon2id。对于存量 Bcrypt 哈希,可在用户下次登录时验证通过后,透明地重新哈希为 Argon2id。
from pwdlib import PasswordHash
password_hash = PasswordHash.recommended() # 默认 Argon2id
# 新密码哈希
hashed = password_hash.hash(password)
# 验证旧 Bcrypt 哈希(需安装 bcrypt 包)
import bcrypt
if bcrypt.checkpw(password.encode(), old_hash.encode()):
# 验证通过,重新哈希为 Argon2id
new_hash = password_hash.hash(password)
# 更新数据库
五、升级与应急响应清单
- 立即排查:检查 Spring Security 版本是否受 CVE-2025-22228 影响,升级至补丁版本。
- Python 生态:若使用 passlib,立即迁移至 pwdlib 或直接使用 bcrypt 包;短期可固定
bcrypt==4.0.1争取时间,但需尽快完成迁移。 - 输入校验:在所有注册/改密接口增加 UTF-8 字节长度校验,拒绝超过 72 字节的密码。
- 审计拼接哈希:全局搜索
bcrypt(调用,确保密码是唯一输入,杜绝与用户名、ID 等拼接。 - 监控告警:对
ValueError: password cannot be longer than 72 bytes及IllegalArgumentException设置日志告警,及时发现兼容性断裂。
升级 bcrypt 至 5.0 前,务必在预发环境全量回归认证流程。passlib 的自检失败会导致所有密码操作不可用,而非仅影响长密码用户。建议采用灰度发布,并准备好回滚方案。
本文核心技术背景源自海外一线技术研究:
Bcrypt Max Password Length: The 72-Byte Limit Explained (DEV Community)
CVE-2025-22228 参考:Spring Security Advisory
