TypeScript错误提示出现Promise<string|number>类型的原因是什么？

你遇到的这个类型推断差异，核心原因通常和TypeScript对Promise.then方法的类型处理逻辑、版本或编译配置有关：

1. 旧版本/非严格模式的推断偏差 #

原生TypeScript对Promise.then的标准类型定义中，当仅传入onFulfilled回调时，返回的Promise类型应为回调返回值的包装（即Promise<string>）。但在部分旧版本TypeScript（如3.x之前）或未启用strict模式的编译环境下，编译器存在类型推断偏差，会错误地将原Promise的resolve类型（number）与回调返回类型（string）合并，最终推断为Promise<string | number>。

2. 宽松类型推断的不确定性 #

如果你的tsconfig.json未开启strict系列配置（如strictFunctionTypes、noImplicitAny），编译器对回调函数的类型检查会更宽松。即便n被推断为number，编译器也可能误判回调存在未明确覆盖的分支，从而将返回类型推断为string | number。

验证与修正方法 #

要让编译器按预期提示Promise<string>与Promise<number>类型不匹配，可以：

• 显式指定回调返回类型：

  const promise: Promise<number> = Promise.resolve(100).then((n: number): string => n.toString());
  

  此时编译器会明确推断返回Promise<string>，报错信息会符合你的预期。
• 升级TypeScript并开启严格模式：将TypeScript升级到最新稳定版本，同时在tsconfig.json中设置"strict": true，严格模式下的类型推断会更精准，不会出现不必要的类型合并。

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