使用await+lean查询Mongoose返回对象时无法访问属性如何解决

问题根因分析 #

1. console.log异步打印的机制问题
   console.log输出对象时存储的是对象引用，你在控制台展开查看时才会读取对象的最新属性。如果console.log(user)和console.log(user.email)执行间隙有异步逻辑修改了user对象，就会出现展开可见email属性、直接访问时值为undefined的错觉。
2. 旧版本Mongoose的lean方法bug
   部分6.0之前的Mongoose版本中，lean方法转换BSON为普通JS对象时存在异常，字段会被挂载到返回对象的内部_doc属性下，未同步到顶层对象。控制台打印全对象时会递归展示内部属性，所以你能看到email，但直接访问顶层属性拿不到值。
3. 代码逻辑混淆
   你提供的回调版本属于错误的混合用法：给findOne传回调时，await拿到的返回值是Mongoose Query实例而非查询结果，你在回调中拿到的user才是Mongoose文档对象，文档对象可以通过原型链的getter访问属性，和lean返回普通对象的场景逻辑完全不同。
4. 数据库字段名不一致
   可能数据库中实际存储的email字段存在大小写差异、前后带不可见空格等问题，打印全对象时不易察觉，但按schema定义的email字段名访问自然返回undefined。

对应解决方案 #

• 首先排查属性是否真实存在，避免console的异步坑，修改打印逻辑验证：

const user = await User.findOne({ _id: '60a12460479e874db836d939' }).lean()
// 打印所有顶层自有属性，确认email是否存在
console.log(Object.keys(user))
// 检查内部_doc属性下是否有email
console.log(user?._doc?.email)
// 序列化后打印，确认序列化结果中是否包含email字段
console.log(JSON.stringify(user))

• 若验证后发现字段在_doc下，可临时手动展开对象解决：

// 方式1：直接取内部_doc
const user = (await User.findOne({ _id: '60a12460479e874db836d939' }).lean())._doc
// 方式2：浅拷贝一层生成新对象
const user = {...await User.findOne({ _id: '60a12460479e874db836d939' }).lean()}
// 建议补充.exec()确保返回标准Promise
const user = await User.findOne({ _id: '60a12460479e874db836d939' }).lean().exec()

• 升级Mongoose到最新稳定版本修复已知bug：

npm install mongoose@latest

• 直接连接数据库查看对应_id的文档，确认存储的字段名和schema定义的email完全一致，无大小写、特殊字符差异。
• 不要混合使用回调和async/await，统一用其中一种异步写法避免逻辑混乱。

内容的提问来源于stack exchange，提问作者desh