泛型类参数约束未传递至类属性：TypeORM类型检查问题

我在TypeScript中结合TypeORM实现泛型AbstractDal类时遇到了类型检查问题：泛型参数已约束为继承拥有id: number属性的IEntity接口，但调用repository.findOneBy({ id })时始终提示类型不兼容，报错信息如下：

src/abstracts/abstract.dal.ts:20:44 - error TS2345: Argument of type '{ id: number; }' is not assignable to parameter of type 'FindOptionsWhere<T> | FindOptionsWhere<T>[]'.
  Types of property 'id' are incompatible.
    Type 'number' is not assignable to type 'FindOptionsWhereProperty<NonNullable<T["id"]>, NonNullable<T["id"]>>'.

我的代码示例：

interface IEntity {
  id: number;
}

export abstract class AbstractDal<T extends IEntity> {
  abstract repository: Repository<T>;

  public async get(id: number): Promise<T> {
    return await this.repository.findOneBy({ id });
  }
}

解决方法 #

这个问题是TypeORM的类型系统与TypeScript泛型推导的交互限制导致的，有几种可行的修复方式：

1. 显式类型断言

直接将查询参数断言为FindOptionsWhere<T>，明确告诉TypeScript类型兼容：

import { FindOptionsWhere, Repository } from "typeorm";

// ...

public async get(id: number): Promise<T> {
  return await this.repository.findOneBy({ id } as FindOptionsWhere<T>);
}

2. 使用TypeORM的查询操作符

通过Equal操作符包装id值，让TypeORM的类型系统正确识别参数类型：

import { Equal, Repository } from "typeorm";

// ...

public async get(id: number): Promise<T> {
  return await this.repository.findOneBy({ id: Equal(id) });
}

3. 强化泛型约束

调整IEntity为泛型接口，明确限定T的id类型为number，减少类型推导的模糊性：

interface IEntity<TId = number> {
  id: TId;
}

export abstract class AbstractDal<T extends IEntity<number>> {
  abstract repository: Repository<T>;

  public async get(id: number): Promise<T> {
    return await this.repository.findOneBy({ id });
  }
}

原因说明 #

虽然T extends IEntity确保了T包含id: number属性，但TypeORM的FindOptionsWhere类型在处理泛型时，无法自动推导T["id"]与传入的number类型完全兼容，需要通过上述方式显式消除类型歧义。

内容的提问来源于stack exchange，提问作者Node.JS