应用层加密应使用 Mongoose pre('save') 钩子,禁用 CSFLE 和存储引擎加密;必须用 function 而非箭头函数以确保 this 指向文档实例;仅当字段被修改且有有效值时加密,并用 AES-GCM 同步解密。

直接结论:用 Mongoose pre('save') 钩子做应用层加密,别碰 CSFLE 或存储引擎加密来处理字段级敏感数据。
CSFLE 要求 MongoDB 7.0+、mongocryptd 进程、企业版或 Atlas,且加密后无法模糊查、范围查、聚合;加密存储引擎是全库磁盘加密,对身份证/手机号这类字段毫无意义。真正可控、可维护、兼容旧环境的方案,只有应用层加密 + pre('save') 守卫。
为什么必须用 pre('save') 普通函数,不能用箭头函数
箭头函数会丢失 this 绑定,导致 this.isModified('phone') 返回 false、this.phone = encrypted 赋值无效、甚至静默跳过加密。Mongoose 中间件依赖 this 指向当前文档实例,这是硬性前提。
- 正确写法:
schema.pre('save', function(next) { ... }) - 错误写法:
schema.pre('save', (next) => { ... })(this指向外层作用域,不是文档) - 验证方式:在钩子里加
console.log(this.constructor.modelName),如果不是模型名(如User),说明this已错
this.isModified() 和空值守卫怎么写才不翻车
只在字段真被改了、且有值时加密,否则要么漏加密(比如更新用户其他字段时身份证没变但也没加密),要么重复加密(密文再套一层加密,解密失败)。
- 必须检查变更:
if (this.isModified('idCard') && this.idCard) - 要排除
null、undefined、空字符串:if (this.isModified('phone') && typeof this.phone === 'string' && this.phone.trim()) - 禁止操作
this._doc.phone:它绕过 Mongoose 的变更追踪,isModified失效,后续验证、序列化都可能出问题 - 赋值用
this.phone = encrypted,不用this.set('phone', encrypted)(可能触发额外 validate 钩子)
选 crypto.createCipheriv 还是 bcrypt?
bcrypt 是单向哈希,只适合密码;身份证、手机号等需要读回明文的字段,必须用可逆加密。Node.js 20 内置 crypto 模块足够安全,无需第三方库。
- 推荐 AES-GCM:
crypto.createCipheriv('aes-256-gcm', key, iv),带认证,防篡改 - 密钥(
key)必须从环境变量或 KMS 加载,绝不能硬编码;IV 每次加密随机生成,和密文一起存(如拼成iv:encrypted字符串) - 避免 ECB 模式:它不随机,相同明文永远产相同密文,极易被模式分析
- 不要自己实现 padding 或 base64 编码逻辑——
cipher.update()和cipher.final()已封装好
最常被忽略的一点:解密逻辑必须同步、无副作用,并且在所有读取路径(findOne、find、populate)中统一触发。Mongoose 没有内置“post-find”解密钩子,得靠 toJSON 或 toObject 方法重写,或在 service 层手动调用解密函数——这点不提前设计,后期补救成本极高。











