gorm 的 beforecreate 和 afterfind 钩子不适合直接做字段加密，因为它们不改写 sql 查询条件，导致加密后无法通过明文条件查询；正确做法是实现 scanner/valuer 接口，让加解密在数据流转层自动完成，且字段需声明为非指针自定义类型。
为什么 GORM 的 BeforeCreate 和 AfterFind 钩子不适合直接做字段加密
因为加密后字段值变成二进制或 Base64 字符串，而数据库列类型通常是 TEXT 或 VARCHAR，看似能存——但问题出在查询和比较上。比如你对 email 字段加密后存入，再用 db.Where("email = ?", "user@example.com").First(&u) 查询，实际查的是密文，必然失败。GORM 钩子本身不接管 SQL 构建逻辑，它只负责“碰巧在某个时机改 struct 字段”，不会自动重写 WHERE 条件。
真正可行的路径是：把加密/解密逻辑下沉到 GORM 的 Scanner / Valuer 接口，让字段在入库前自动加密、查出后自动解密，对业务层完全透明。
如何为敏感字段实现 Scanner 和 Valuer 接口
以 AES-256-GCM 加密 phone 字段为例，需定义一个包装类型（不能直接在 string 上实现接口），并确保加解密密钥不硬编码、IV 不复用：
- 定义新类型
EncryptedString，内嵌string便于赋值 -
Scan方法接收数据库原始[]byte，先 Base64 解码，再用固定 IV（或从密文头提取）AES-GCM 解密 -
Value方法对明文调用 AES-GCM 加密，拼接 nonce + ciphertext，再 Base64 编码后返回driver.Value - 密钥建议从环境变量读取：
os.Getenv("ENCRYPTION_KEY")，长度必须为 32 字节
示例片段：
type EncryptedString string
func (e *EncryptedString) Scan(value interface{}) error {
if value == nil {
return nil
}
b, ok := value.([]byte)
if !ok {
return fmt.Errorf("cannot scan %T into EncryptedString", value)
}
decoded, _ := base64.StdEncoding.DecodeString(string(b))
// 此处调用你的 AES-GCM 解密函数，输出明文到 *e
plain, err := decryptGCM(decoded, key)
*e = EncryptedString(plain)
return err
}
func (e EncryptedString) Value() (driver.Value, error) {
if len(e) == 0 {
return nil, nil
}
cipher, err := encryptGCM(string(e), key)
if err != nil {
return nil, err
}
return base64.StdEncoding.EncodeToString(cipher), nil
}
如何在 GORM 模型中正确使用加密字段类型
关键点在于：字段必须声明为自定义类型，且不能用指针（*EncryptedString），否则 Scan 不会被调用；同时要禁用 GORM 的零值覆盖行为：
- 模型字段定义为
Phone EncryptedString `gorm:"type:varchar(255);not null"` - 避免写成
Phone *EncryptedString——Scan只对非指针类型生效 - 如果该字段允许为空，需额外实现
sql.Scanner对nil的兼容（即value == nil时设为空字符串或跳过） - GORM v2 默认会将零值字段设为
NULL，若加密字段是空字符串，应显式设置default:''或用gorm:"default:''"
错误示范：Phone *EncryptedString → 解密永远不触发，数据库存的是原始空指针值。
加密字段能否参与 WHERE 查询或 ORDER BY
不能。这是最常被忽略的硬限制：GORM 的 Valuer/Scanner 只影响 Go 层数据流转，SQL 语句本身仍按明文字段名生成。你写 db.Where("phone = ?", "138****1234")，实际发往数据库的是明文条件，而库里存的是密文，必然不匹配。
可行方案只有两个：
- 改用应用层过滤：查出全量或宽泛结果后，在 Go 内存中遍历比对解密后的值（仅适用于小数据集）
- 在数据库侧建加密索引列（如
phone_encrypted_hash），用 HMAC(SHA256) 对明文+盐计算摘要，查询时对输入也计算一次哈希去匹配——但这已脱离 GORM 钩子范畴，属于架构设计选择
别试图给 EncryptedString 实现 clause.Expression 来改写 SQL，GORM 不支持运行时动态替换字段名，且会破坏预编译语句安全性。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
