密码必须用 bcrypt,其他敏感字段(如手机号、身份证号)必须用 AES-256-GCM——这是底线,不能混用或降级。很多开发者在这里栽过跟头,以为“都是加密,换着用也没事”,结果要么业务逻辑崩盘,要么数据安全形同虚设。下面把几个关键要点拆开说清楚。

密码用 bcrypt,其他敏感字段(如手机号、身份证号)必须用 AES-256-GCM,不能混用或降级。
bcrypt 只能用于密码哈希,别拿它加密 API Key 或手机号
bcrypt 是专为密码设计的慢哈希函数,带 salt 且计算成本可调,但它是单向的——无法“解密”。一旦你用 bcrypt.hashpw() 处理了用户的手机号,就永远拿不回原始值,业务直接崩。
- ✅ 正确用途:用户登录密码存储(
bcrypt.hashpw(password.encode(), bcrypt.gensalt(rounds=14))) - ❌ 错误用途:加密数据库里的
id_card字段、bank_account、api_token - ⚠️ 风险点:有人图省事把所有字段都丢进 bcrypt,结果发现查不到明文、改不了数据、导不出报表
AES-256-GCM 是当前 Python 生产环境最稳妥的对称加密选择
相比 ECB/CBC 模式,GCM 提供认证加密(AEAD),自带完整性校验,解密时自动拒绝被篡改的密文——这点在数据库字段级加密中极其关键。用 pycryptodome 而非过时的 pycrypto,且必须显式处理 nonce 和 tag。
- 密钥长度必须为 32 字节(AES-256),用
secrets.token_bytes(32)生成,绝不用字符串硬编码 - 每次加密都要新生成 12 字节 nonce:
nonce = secrets.token_bytes(12),不能复用 - 解密失败时捕获
ValueError(如 tag 不匹配)和UnicodeDecodeError(解密后非 UTF-8),不要静默吞掉异常 - 示例片段(简化版):
from Crypto.Cipher import AES from Crypto.Random import get_random_bytes from Crypto.Util.Padding import pad, unpad def aes_encrypt_gcm(plaintext: bytes, key: bytes) -> bytes: cipher = AES.new(key, AES.MODE_GCM) ciphertext, tag = cipher.encrypt_and_digest(pad(plaintext, AES.block_size)) return cipher.nonce + tag + ciphertext # 拼接后存入 DB def aes_decrypt_gcm(data: bytes, key: bytes) -> str: nonce, tag, ciphertext = data[:12], data[12:28], data[28:] cipher = AES.new(key, AES.MODE_GCM, nonce=nonce) decrypted = unpad(cipher.decrypt_and_verify(ciphertext, tag), AES.block_size) return decrypted.decode('utf-8')
密钥绝对不能出现在代码或配置文件里
哪怕加了 .gitignore,硬编码密钥仍是高危操作。Python 后端启动时若从环境变量读 AES_KEY,而该变量值是明文 base64,等于没保护。
- ✅ 推荐路径:用系统级密钥管理服务(KMS),如 AWS KMS、Azure Key Vault,或本地 HashiCorp Vault;Python 通过 SDK 获取解密后的密钥字节
- ✅ 退而求其次:使用操作系统级凭据存储(Linux 的
systemd-secrets、macOS 的 Keychain),配合keyring库读取 - ❌ 危险操作:
os.getenv("AES_KEY")直接当密钥用;base64.b64decode(os.getenv("AES_KEY_B64"))仍属硬编码变体 - ⚠️ 注意:KMS 调用有延迟和配额限制,建议在应用初始化阶段缓存解密后的密钥(内存中),避免每次加解密都请求 KMS
真正容易被忽略的是字段生命周期管理:加密字段一旦写入数据库,后续所有 ORM 查询、序列化、日志打印、审计导出环节,都必须明确知道“此处是密文”,否则可能意外记录、暴露或破坏格式。AES 加密后的二进制数据必须用 base64 或十六进制编码再落库,且字段类型要匹配(如 MySQL 用 TEXT 或 BLOB,不能塞进 VARCHAR(32))。