NestJS+TypeORM通用BaseRepository中findOneBy类型错误修复咨询

在NestJS项目中实现BaseRepository抽象类时，findOneById方法里用FindOptionsWhere<T>定义{ id: id }出现类型错误，核心原因是TypeScript无法推断泛型T包含id字段。以下是几种可行的修复方案：

方案一：给泛型T添加类型约束（推荐） #

定义一个基础实体接口，强制所有继承的实体必须包含id字段，让BaseRepository的泛型T继承该接口，从根源解决类型推断问题：

// 新增基础实体接口，统一约束实体必须有id字段
export interface BaseEntity {
  id: number;
}

// 修改BaseRepositoryInterface的泛型约束
export interface BaseRepositoryInterface<T extends BaseEntity> {
    create(data: DeepPartial<T>): T
    findOneById(id: number): Promise<T>
    findAll(options?: FindManyOptions<T>): Promise<T[]>
}

// 修改BaseRepository抽象类的泛型约束
export abstract class BaseRepository<T extends BaseEntity> implements BaseRepositoryInterface<T> {
    private entity: Repository<T>;

    protected constructor(entity: Repository<T>) {
        this.entity = entity;
    }

    public create(data: DeepPartial<T>): T {
        return this.entity.create(data)
    }

    public async findOneById(id: number): Promise<T> {
        const options: FindOptionsWhere<T> = { id } // 此时类型推断正常，无错误
        return await this.entity.findOneBy(options)
    }

    public async findAll(options?: FindManyOptions<T>): Promise<T[]> {
        return await this.entity.find(options)
    }
}

方案二：使用类型断言（应急方案） #

如果不想修改泛型约束逻辑，可以临时用类型断言绕过TypeScript的检查，但需确保所有业务实体确实都包含id字段，避免运行时异常：

public async findOneById(id: number): Promise<T> {
    const options = { id } as FindOptionsWhere<T>
    return await this.entity.findOneBy(options)
}

方案三：简化查询写法 #

TypeORM的findOneBy支持直接传入字段条件，也可以直接简化代码，同时通过类型断言解决类型问题：

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

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