Mongoose save()保存文档后如何正确筛选或省略返回客户端的属性
为什么直接修改save()返回的文档不生效
Mongoose的save()方法返回的并非普通JavaScript原生对象,而是Mongoose封装的Document类实例。这类实例内置了Schema规则校验、属性变更追踪、序列化逻辑拦截等一整套管控机制,直接在上面修改属性会出现很多预期外的问题:
- Document实例的业务属性并非普通的赋值属性,而是通过getter/setter描述符从Mongoose内部状态层读取的,你执行
delete someDoc.propName时,根本移除不掉定义在对象描述符上的getter方法,后续读取属性还是能拿到内部存储的真实值 - 当Express通过
res.send触发对象序列化时,Mongoose并不会读取实例外层的临时修改内容,而是调用自身内置的toJSON方法从内部状态生成最终的序列化结果,所以你外层做的删除操作完全不会体现在返回内容里 - 你之前用深拷贝能生效,本质是深拷贝过程把受Mongoose管控的Document实例转成了完全不受管控的原生普通JS对象,后续的修改会直接体现在序列化结果里
为什么lodash的写法没有生效
你写的lodash代码不生效,存在两个核心问题:
- 第一,
_.pick()方法执行后会返回一个全新的筛选后的对象,但你的代码没有接住这个返回值,最后发送给客户端的还是原始的someDoc实例,自然看不到任何筛选效果 - 第二,就算你接住了返回值,直接把Mongoose Document实例传给
_.pick()也拿不到正确结果:_.pick的工作逻辑是读取传入对象自身的可枚举属性,而Document实例的业务属性是通过非枚举的getter暴露的,并非直接挂在实例的可枚举自有属性上,lodash遍历的时候根本拿不到这些真实的业务属性,最终筛选出来的结果会是空值或者不完整
这类场景的最佳实践
完全不需要手动深拷贝或者在原始Document上硬改属性,用Mongoose原生提供的能力就能实现优雅的字段筛选:
- 长期通用场景:在Schema定义阶段配置全局的序列化转换规则,只要Document触发序列化(包括
res.send自动触发的JSON转换),就会自动过滤敏感/不需要返回的字段。比如在Schema上配置:
配置完成后,所有通过save返回的Document在发给客户端时,都会自动完成字段过滤,不需要每次写业务代码重复处理userSchema.set('toJSON', { transform: (doc, returnObj) => { // 直接删除需要省略的字段 delete returnObj.password; delete returnObj.__v; return returnObj; } }) - 临时自定义筛选场景:先通过Document内置的
toObject()方法把受管控的实例转成原生普通JS对象,再配合lodash的pick/omit做字段筛选,此时lodash可以正常读取所有属性,代码示例:const savedDoc = await page.save() // 先转成原生对象,脱离Mongoose管控 const plainDoc = savedDoc.toObject() // 再用lodash筛选指定字段,此时方法返回的对象直接发给客户端即可 const filteredDoc = _.pick(plainDoc, ['propName1', 'propName2']) res.send(filteredDoc) - 注意规避的误区:不要直接在原始Mongoose Document实例上执行delete操作;不要忘记接收工具方法的返回值;不要手动写递归深拷贝实现属性剥离,Mongoose原生的
toObject/toJSON方法性能远高于手动深拷贝,而且和Mongoose的内部逻辑完全兼容。
内容的提问来源于stack exchange,提问作者xebok
相关产品推荐
相关产品推荐

