移除async关键字为何会改变TypeScript函数返回类型

• async 函数存在自动包装机制：只要函数被标记为async，TypeScript 会强制将函数的返回值规整为原生Promise<T>类型：无论函数内部返回的是普通值、原生Promise、还是带then方法的thenable对象（比如Mongoose的查询实例），都会被自动解包后包装为标准Promise，泛型参数取内部最终返回的值类型。
  你最初带async的写法里，虽然MyModel.countDocuments({})本身返回的不是原生Promise，但async自动完成了类型包装和解包，最终返回类型刚好匹配你标注的Promise<number>，所以不会报类型错误。
• Mongoose 的查询方法默认不返回原生Promise：countDocuments()、find()这类Mongoose查询方法，返回值是Mongoose内部实现的QueryWithHelpers类型实例。这个对象实现了then/catch方法，属于thenable对象，可以被await、也可以链式调用then，但它的静态类型就是你看到的那串结构复杂的自定义查询类型，本身不属于Promise<number>类型。

当你移除async修饰符后，函数直接返回这个Query实例，返回值类型就是这个复杂的Mongoose查询类型，和你标注的Promise<number>类型不兼容，自然会抛出TypeScript类型错误。

• 保留async关键字：这是最简便的写法，依靠async的自动包装能力完成类型适配，代码可以正常运行。
• 移除async时手动调用.exec()：Mongoose为Query实例提供了exec()方法，调用后会直接返回标准原生Promise，类型完全匹配Promise<number>，代码示例：

getDocCount(): Promise<number> {
   return MyModel.countDocuments({}).exec();
}

注意：Mongoose官方更推荐使用.exec()执行查询，这种写法能输出更清晰的错误栈，类型推导也更稳定。

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