Promise 类型解包混淆
快速摘要
你的异步函数返回 Promise<T> 但 TypeScript 推断 Promise<Promise<T>> —— async 已将返回包装在 Promise 中。
为什么发生
异步函数显式返回 Promise,导致双重包装:async function f(): Promise<Promise<T>>
你在异步函数内 await 了值并返回它,未意识到 await 已解包 Promise
非异步函数返回意外类型化为 Promise<T> 而非 T 的值
最小示例
✗ 错误代码
async function getData(): Promise<Promise<string>> {
return Promise.resolve('hello'); // double-wrapped!
}
// Type is Promise<Promise<string>>, but runtime is Promise<string>✓ 修复代码
async function getData(): Promise<string> {
return 'hello'; // async wraps it in Promise
}
// Or non-async:
function getData(): Promise<string> {
return Promise.resolve('hello');
}异步函数自动将返回值包装在 Promise 中,因此返回类型应为 Promise<T> 而非 Promise<Promise<T>>。
如何诊断
悬停函数返回类型查看是否双重包装为 Promise<Promise<T>>
检查函数是否为 async —— async 函数自动将返回包装在 Promise 中
记录运行时值查看它是 Promise 对象还是已解包的值
如何修复
从异步函数返回类型中移除显式 Promise 包装 —— async 处理它
如果从异步函数返回 Promise 则移除不必要的 await
需要时使用 Promise.resolve(value) 显式将值包装在 Promise 中
如何预防
记住异步函数自动将返回值包装在 Promise 中 —— 不要双重包装
在类型级代码中使用 Awaited<T>(TS 4.5+)解包 Promise 类型
相关资源
相关课程
- Async/Await
学习异步类型。