不能直接用hashlib.md5()或sha256()存密码,因其无盐、单次哈希、易被彩虹表和暴力破解;必须用passlib或bcrypt等专用密码哈希库,自动加盐、多轮迭代、恒定时间比较。

为什么不能直接用 hashlib.md5() 或 hashlib.sha256() 存密码
直接哈希明文密码(比如 hashlib.sha256(b"123456").hexdigest())看似加密,实则完全不安全。攻击者用彩虹表或暴力跑字典几秒就能反查出常见密码;更糟的是,相同密码会生成相同哈希值,一眼能看出哪些用户密码雷同。现代系统必须加盐(salt)且使用慢哈希(slow hash)——而 hashlib 自带的函数全都不满足这两点。
应该用 passlib 或 bcrypt,而不是纯 hashlib
hashlib 是通用哈希工具,不是密码哈希库。它不自动加盐、不控制迭代轮数、不防时序攻击。真正该用的是专为密码设计的库:
-
passlib(推荐新手):API 统一,内置多种方案,一行生成+验证,自动处理 salt 和 rounds -
bcrypt:成熟稳定,Python 有bcrypt包,但需手动处理 salt 生成和比对逻辑
示例(passlib):
from passlib.hash import pbkdf2_sha256
<h1>加密(自动加盐 + 默认 29000 轮迭代)</h1><p>hashed = pbkdf2_sha256.hash("my_password")</p><h1>验证(自动提取 salt 和参数,无需你操心)</h1><p>pbkdf2_sha256.verify("my_password", hashed) # → True
pbkdf2_sha256.verify("wrong", hashed) # → False
</p>
注意:pbkdf2_sha256 生成的字符串自带算法标识、salt、rounds 等元信息,存数据库时直接存整个字符串即可,不用拆解。
如果硬要用 hashlib,至少得手动加盐+多轮迭代
仅限教学或极简场景,生产环境请跳过这步。关键点:
- 盐必须随机、足够长(至少 16 字节),每次加密都不同 —— 用
os.urandom(16),别用random - 哈希必须多轮(如 100,000 次
sha256),否则速度太快,易被爆破 - 存储时必须同时保存 salt 和最终哈希值(例如拼成
salt.hex() + ":" + hash_hex),验证时要重新执行全部流程
错误示范(无盐、单次哈希):
# ❌ 危险!不要这样用 hashlib.sha256(b"password").hexdigest()
勉强可用的最小手动实现(仍不推荐):
import hashlib
import os
<p>def hash_password(password: str) -> str:
salt = os.urandom(16)
pwd<em>bytes = password.encode()
for </em> in range(100_000):
pwd_bytes = hashlib.pbkdf2_hmac("sha256", pwd_bytes, salt, 1)
return salt.hex() + ":" + pwd_bytes.hex()</p><p>def verify_password(password: str, stored: str) -> bool:
salt_hex, hash_hex = stored.split(":", 1)
salt = bytes.fromhex(salt_hex)
pwd<em>bytes = password.encode()
for </em> in range(100_000):
pwd_bytes = hashlib.pbkdf2_hmac("sha256", pwd_bytes, salt, 1)
return pwd_bytes.hex() == hash_hex
</p>
验证时最容易忽略的两个细节
一是用 passlib.verify() 而不是 == 直接比对字符串 —— 它内部做了恒定时间比较(timing-safe compare),防止时序攻击;二是确保验证时传入的是原始明文密码,不是再哈希一次的结果。常见错误:
- 把用户提交的密码先
hashlib.sha256().hexdigest()再传给verify()→ 永远失败 - 从数据库读出哈希后,用
if user_hash == verify_result:手动比较 → 引入时序侧信道 - 盐存在配置文件或全局变量里(“固定盐”)→ 失去加盐意义,等同于无盐
真实项目里,密码哈希不是“会不会写”的问题,而是“敢不敢自己造轮子”的问题。用错方案的成本远高于学一个新包 —— 用户密码泄露没有补救机会。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











