NestJS/TypeORM自定义仓库方法在Service中无法调用

问题根源 #

这个报错的核心原因是注入的实例并非你自定义的TenantRepository，而是TypeORM默认的Repository实例，默认实例没有你定义的createTenant方法，因此运行时触发错误。VSCode有提示是因为TypeScript类型校验通过了，但运行时实例不匹配。

下面分两种TypeORM版本场景给出修复方案：

场景1：使用TypeORM 0.3.x及以上版本 #

TypeORM 0.3.x开始彻底移除了@EntityRepository装饰器，旧的自定义仓库写法不再生效。

修复步骤：

1. 改造自定义仓库：移除@EntityRepository，改用@Injectable装饰，通过DataSource初始化仓库：

import { DataSource, Repository } from 'typeorm';
import { Injectable } from '@nestjs/common';
import { TenantEntity } from './entities/tenant.entity';
import { CreateTenantDto } from './dto/create-tenant.dto';

@Injectable()
export class TenantRepository extends Repository<TenantEntity> {
  constructor(private dataSource: DataSource) {
    super(TenantEntity, dataSource.createEntityManager());
  }

  async createTenant(createTenantDto: CreateTenantDto): Promise<TenantEntity> {
    const { name, email } = createTenantDto;
    // 改用Repository内置的create方法创建实体（更符合TypeORM规范）
    const newTenant = this.create({ name, email });
    return await this.save(newTenant);
  }
}

2. 修改模块配置：在TypeOrmModule.forFeature中明确绑定实体与自定义仓库：

import { TenantRepository } from './tenant.repository';
import { TenantEntity } from './entities/tenant.entity';

@Module({
  imports: [
    TypeOrmModule.forFeature([{ 
      name: TenantEntity, 
      useClass: TenantRepository 
    }]),
  ],
  controllers: [TenantsController],
  providers: [TenantsService],
})
export class TenantsModule { }

3. 服务中的注入代码保持不变即可。

场景2：使用TypeORM 0.2.x及以下版本 #

如果仍在使用旧版本，问题出在模块配置时TypeOrmModule.forFeature传入了仓库类而非实体类。

修复步骤：

仅需修改tenants.module.ts的imports部分，传入实体类而非仓库：

import { TenantEntity } from './entities/tenant.entity';

@Module({
  imports: [
    TypeOrmModule.forFeature([TenantEntity]), // 这里传实体，不是仓库类
  ],
  controllers: [TenantsController],
  providers: [TenantsService],
})
export class TenantsModule { }

TenantRepository和TenantsService的代码无需改动。

额外检查项 #

1. 查看package.json确认typeorm版本，对应选择上述方案。
2. 重启NestJS服务，避免热重载不彻底导致代码未更新。

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