Skip to content

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 类型

相关资源

相关术语

相关课程

← 返回语言