TypeScript中多返回类型Promise的类型断言使用问题

你遇到的参数位置断言报错是语法写法错误导致的：(resp as SimpleResponseType) => {}会被TS识别为「把SimpleResponseType类型的值作为回调函数传入」，而非「给回调参数resp标注类型」，自然会报类型不匹配错误。

以下是按优先级排序的规范实现方案： #

1. 类型守卫收窄类型（最推荐，类型安全） #

硬断言本质是绕过TS校验，没有运行时保护，优先用类型守卫同时实现编译时类型收窄和运行时结构校验：

interface SimpleResponseType {
   key1: string
};

interface SimpleResponseType2 {
   property1: string
   property2: number 
};

// 定义类型守卫
function isType1(resp: SimpleResponseType | SimpleResponseType2): resp is SimpleResponseType {
  return 'key1' in resp;
}

interface ServiceType {
   fetchResponse: () => Promise<SimpleResponseType | SimpleResponseType2> 
};

class Service implements ServiceType {
   async fetchResponse() {
      return { key1: 'json' };
   };
};

const service = new Service();

await service.fetchResponse().then(resp => {
  if (isType1(resp)) {
    // TS自动收窄为SimpleResponseType，可直接访问key1
    console.log(resp.key1)
  } else {
    // 此处自动识别为SimpleResponseType2
    console.log(resp.property1, resp.property2)
  }
})

这种写法不会出现类型逃逸，即使接口返回结构不符合预期也能在运行时走到对应分支，不会抛出属性不存在的JS错误。

2. 直接标注回调参数类型（确定返回结构时使用） #

如果你100%确定当前调用场景下接口只会返回SimpleResponseType，可以直接在回调参数位置写类型标注，不需要单独在函数内声明变量做断言：

await service.fetchResponse().then((resp: SimpleResponseType) => {
  console.log(resp.key1)
})

这个写法和你之前在函数内写const respTyped = resp as SimpleResponseType效果完全一致，都是硬断言，不会做运行时校验。

3. 泛型指定Promise返回类型 #

也可以直接在调用时断言整个Promise的返回类型，适合接口本身有明确泛型定义的场景：

await (service.fetchResponse() as Promise<SimpleResponseType>).then(resp => {
  console.log(resp.key1)
})

原报错信息参考：

Property 'key1' does not exist on type 'SimpleResponseType2'.ts(2339)

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