TypeScript中Promise then回调参数类型无法赋值报错如何解决

报错原因 #

这个报错的核心是你用到的Promise实例没有显式声明返回值的泛型类型，TypeScript会默认将其resolve的值类型推断为unknown，而你的then回调声明了入参是自定义泛型T，unknown类型无法直接赋值给任意自定义类型T，因此触发类型校验失败。

解决方案 #

方案1：给Promise显式指定泛型（最推荐）

在创建Promise时直接声明其返回值类型为T，类型系统会自动将then回调的入参类型推导为T，不会再报类型冲突：

// 错误写法：未指定泛型，默认返回Promise<unknown>
const wrongPromise = new Promise((resolve) => {
  resolve({ /* 你要返回的T类型数据 */ })
})

// 正确写法：指定泛型为T
const correctPromise = new Promise<T>((resolve) => {
  resolve({ /* 你要返回的T类型数据 */ })
})

correctPromise.then((value) => {
  // 这里value的类型会自动识别为T，无需额外声明
  console.log(value)
})

方案2：类型断言兜底

如果你无法修改Promise的创建逻辑（比如调用第三方封装的返回Promise的方法），可以在回调内对入参做类型断言：

unknownPromise.then((value) => {
  const typedValue = value as T
  // 后续用typedValue处理业务逻辑
})

如果是第三方方法返回的Promise，也可以直接对整个Promise实例做断言：

(thirdPartyMethod() as Promise<T>).then((value) => {
  // value类型为T
})

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