TypeScript泛型接口函数参数类型推断错误求助

我定义了如下泛型接口：

export interface BaseService {
   getById<T extends number | string>(id: T): Promise<SomeType>;
}

通过以下类实现该接口时出现报错：

export class AService implements BaseService {
    async getById(id: number): Promise<SomeType> {
       // logic
    }

    //Other functions will be implemented here
}

报错信息：

Property 'getById' in type 'AService' is not assignable to the same property in base 
type 'BaseService'.
Type '(id: number) => Promise<SomeType>' is not assignable to type '<T extends 
string | number>(id: T) => Promise<SomeType>'.
Types of parameters 'id' and 'id' are incompatible.
  Type 'T' is not assignable to type 'number'.
    Type 'string | number' is not assignable to type 'number'.
      Type 'string' is not assignable to type 'number'.ts(2416)

尝试了两种修改方式：

1. 限定泛型为number，可行但无法满足部分方法需要string类型id的需求：

getById<T extends number>(id: T): Promise<SomeType>;

2. 去掉泛型约束，仍报错：

getById<T>(id: T): Promise<SomeType>;

接口中的getById是泛型方法，要求实现类的方法必须支持number | string范围内的任意类型作为入参。但你实现的方法仅接受number类型，违反了接口契约——接口要求方法对所有T extends number | string都有效，而你的实现只对T=number生效，因此触发类型错误。

方案1：将泛型提升到接口级别 #

把泛型定义在接口上，每个实现类可以指定专属的id类型，既满足接口约束，又能灵活适配不同id类型需求：

export interface BaseService<T extends number | string> {
   getById(id: T): Promise<SomeType>;
}

// 适配number类型id的服务类
export class AService implements BaseService<number> {
    async getById(id: number): Promise<SomeType> {
       // number类型处理逻辑
    }
}

// 适配string类型id的服务类
export class BService implements BaseService<string> {
    async getById(id: string): Promise<SomeType> {
       // string类型处理逻辑
    }
}

这种方式让每个服务类职责更清晰，完全符合TypeScript类型检查规则。

方案2：实现兼容双类型的泛型方法 #

若单个服务类需要getById同时支持number和string，可保留泛型约束并兼容两种类型的处理逻辑：

export class AService implements BaseService {
    async getById<T extends number | string>(id: T): Promise<SomeType> {
       if (typeof id === 'number') {
           // number类型专属逻辑
       } else {
           // string类型专属逻辑
       }
    }
}

该实现完全匹配接口的泛型方法要求，不会触发类型错误。

方案3：使用方法重载（类型提示更明确） #

如果需要在代码中明确区分两种类型的处理逻辑，可采用方法重载：

export interface BaseService {
   getById(id: number): Promise<SomeType>;
   getById(id: string): Promise<SomeType>;
}

export class AService implements BaseService {
    async getById(id: number): Promise<SomeType>;
    async getById(id: string): Promise<SomeType>;
    async getById(id: number | string): Promise<SomeType> {
       if (typeof id === 'number') {
           // number类型逻辑
       } else {
           // string类型逻辑
       }
    }
}

此方式相比泛型方法，调用时的类型提示更精准，传入不同类型id会得到明确的类型推断。

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