密码必须用 bcrypt，其他敏感字段如手机号、身份证号必须用 AES-256-GCM 加密；bcrypt 是单向哈希，不可用于需解密的场景；AES-256-GCM 提供认证加密，需正确处理 nonce 和 tag，密钥须通过 KMS 或安全凭据存储管理，严禁硬编码。
密码用 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 <p>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</p><p>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，等于没保护。
立即学习“Python免费学习笔记（深入）”；
- ✅ 推荐路径：用系统级密钥管理服务（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)）。
