加密字段必须继承EncryptedField并实现from_db_value、to_python、get_prep_value、get_db_prep_save四个方法；AES-256-GCM需拼接nonce与tag；密钥须用PBKDF2从SECRET_KEY派生；查询无法索引，需额外search_hash字段。
加密字段必须继承 EncryptedField 而不是直接改写 to_python
很多开发者尝试在普通 CharField 里重载 to_python 和 get_prep_value，结果发现 admin 界面乱码、filter 查询失效、迁移生成异常——根本原因是 Django 字段生命周期中，from_db_value 和 get_db_prep_save 的调用时机与序列化逻辑严格耦合。正确做法是继承 Field 并完整实现四个核心方法：from_db_value（从数据库读取后解密）、to_python（反序列化时解密）、get_prep_value（存入前加密）、get_db_prep_save（保存前再加密，避免被其他 hook 干扰）。漏掉任意一个，都可能在 ORM 缓存、JSONField 嵌套或 bulk_create 场景下暴露明文。
AES-256-GCM 比 AES-CBC 更安全，但必须处理 nonce 和 tag
Django 默认不提供 AEAD 模式支持，硬套 pycryptodome 的 AES.new(..., mode=AES.MODE_GCM) 会因每次加密生成随机 nonce 导致无法解密。正确姿势是：把 nonce 和认证 tag 与密文拼接存储（例如 nonce + ciphertext + tag），长度固定为 12+?+16 字节；解密时先切片取出 nonce，再用同一 nonce 初始化 GCM 实例验证 tag。若强行用 CBC，必须配 PKCS7 填充 + 固定 IV（不推荐），否则遇到空字符串或特殊字节会抛 ValueError: Data must be padded to block boundary。
密钥不能硬编码，必须走 settings.SECRET_KEY 衍生或环境变量
直接写死 b'32_byte_secret_key_here_12345678' 是高危操作。Django 的 SECRET_KEY 长度不固定且含非 ASCII 字符，需用 hashlib.pbkdf2_hmac('sha256', settings.SECRET_KEY.encode(), b'django-encrypted-field-v1', 100_000, dklen=32) 衍生出 AES-256 密钥。若部署多实例，必须确保所有节点使用相同 SECRET_KEY，否则旧数据无法解密。另外，别用 os.environ.get('ENCRYPTION_KEY') 直接当密钥——环境变量易被进程列表泄露，且没做长度校验，可能触发 KeyError: 'Invalid key length'。
强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该
查询时无法走数据库索引，filter(encrypted_field='xxx') 必须转成全表扫描
加密字段本质是「确定性不可逆变换」，数据库只能看到密文 blob，无法对原始值建索引或执行 LIKE、__icontains。如果业务强依赖模糊搜索，得额外加一个 search_hash = models.CharField(max_length=64, db_index=True) 字段，存 hashlib.sha256(value.lower().encode()).hexdigest() 用于等值匹配。注意：这牺牲了部分隐私性，且需在 save() 中同步更新。还有个坑是 admin 的 search_fields 若包含加密字段，会静默忽略——Django 不报错，但搜索框永远无结果。
立即学习“Python免费学习笔记（深入）”；
加密字段的真正复杂点不在算法本身，而在它和 Django ORM 生命周期、数据库索引机制、部署密钥一致性之间的隐式耦合。哪怕 AES 实现完全正确，只要漏掉from_db_value 或密钥派生少一轮迭代，生产环境就可能批量解密失败。 
