如何为返回动态对象的API创建接口替代Observable<any>？

我调用服务的代码如下：

save(values: any): Observable<any> {
  return this.httpClient.put(environment.apiBaseUrl, values)
}

我不想用any作为Observable的泛型类型，希望改用接口，但API返回的对象非常动态，它可能是：

{
    "id": 4,
    "status": "ok"
}

也可能是：

{
    "errors": {
        "serviceName": "Has no value",
        "hourlyRate": "Value should not be 0",
        "recipientEmail": "Has no value"
    },
    "status": "bad"
}

尤其是errors中的字段数量不固定，可能多可能少。

请问我是否应该创建动态接口？如果应该，该如何创建？如果不应该，有什么替代方案？

1. 不存在「动态接口」，用联合类型+索引签名即可覆盖需求 #

TypeScript的接口是静态类型定义，没有真正意义上的动态接口。你可以通过联合类型+索引签名定义出适配两种返回场景的类型，同时保留errors字段的灵活性：

// 用索引签名定义错误对象，支持任意字符串键值对
type ApiErrors = {
  [key: string]: string;
};

// 定义API返回的联合类型，覆盖成功/失败两种情况
type ApiResponse = 
  | { status: "ok"; id: number }
  | { status: "bad"; errors: ApiErrors };

// 改造后的服务方法
save(values: any): Observable<ApiResponse> {
  return this.httpClient.put<ApiResponse>(environment.apiBaseUrl, values);
}

2. 使用时的类型守卫 #

调用方法后，通过status字段可以自动触发TypeScript的类型推断，无需额外断言：

this.save(formValues).subscribe(response => {
  if (response.status === "ok") {
    // 此处TypeScript自动识别response包含id字段
    console.log("保存成功，ID:", response.id);
  } else {
    // 此处自动识别response包含errors字段，可遍历所有错误
    Object.entries(response.errors).forEach(([field, message]) => {
      console.log(`${field}错误：${message}`);
    });
  }
});

3. 临时替代方案：用unknown代替any #

如果暂时不想定义具体类型，unknown是比any更安全的选择——它会强制你在使用时做类型检查，避免随意访问不存在的字段：

save(values: any): Observable<unknown> {
  return this.httpClient.put(environment.apiBaseUrl, values);
}

// 使用时必须先做类型校验或断言
this.save(formValues).subscribe(response => {
  if (typeof response === 'object' && response !== null && 'status' in response) {
    const res = response as ApiResponse;
    if (res.status === "ok") {
      console.log(res.id);
    }
  }
});

总结 #

• 优先选择联合类型+索引签名的方案，既保证类型安全，又能适配动态返回结构
• 绝对避免滥用any，临时替代用unknown更稳妥
• TypeScript没有真正的动态接口，静态类型定义完全能覆盖这类动态返回的场景

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