Mongoose查询未调用exec()时为何可直接使用await获取结果

Mongoose 查询方法（比如findOne、find）返回的Query对象本身实现了Thenable 接口，自带符合 Promise A+ 规范的.then()、.catch()方法，这是不需要调用exec()就能直接用await的核心原因。

JavaScript的await关键字不会强制要求等待值必须是原生Promise实例，只要等待的目标是带有then方法的thenable对象，就会自动按照Promise的逻辑处理：调用对象的then方法，等待异步操作完成后拿到 resolved 的结果，操作报错时也会正常抛出异常。

你可以用一段简单的代码验证这个特性：

const query = User.findOne({/* 查询条件 */})
// Query实例上确实存在then方法，属于标准thenable
console.log(typeof query.then === 'function') // 输出 true
// 所以既可以直接await，也可以手动调用then/catch链式调用
query.then(user => {
  // 拿到查询结果
}).catch(err => {
  // 捕获查询错误
})

两种写法的细微区别 #

虽然直接await查询和await加.exec()都能拿到正确结果，但两者存在一点差异：

• 直接await Query对象时，是JS引擎自动对thenable做封装转换，最终返回查询到的文档，错误也会正常抛出，但部分场景下异步堆栈追踪的清晰度不如原生Promise
• 调用.exec()会显式返回一个原生Promise实例，这个Promise的resolve值就是查询结果，异步错误堆栈更清晰，在需要严格判断Promise类型、或需要搭配一些只认原生Promise的工具方法时兼容性更好。当前维护版本的Mongoose已经把两种写法的行为基本对齐，日常开发两种写法都可以正常使用。

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