NestJS依赖注入使用接口触发循环引用问题求助

我为实现多仓库复用，创建了泛型接口IBaseRepository<T>和实现它的泛型抽象类BaseAbstractRepository<T>，应用内所有实体仓库类均继承该抽象类并对应TypeORM实体。在ProductsService中直接注入ProductsRepository类时运行正常，但改用DI TokenEProductsProviders.REPOSITORY注入、并将构造函数参数类型指定为IProductsRepository接口时，触发循环引用错误：

A circular dependency has been detected inside ProductsModule

抽象仓库接口与抽象类 #

export interface IBaseRepository<T> {
  findAll(options?: FindManyOptions<T>): Promise<T[]>;
} 

export abstract class BaseAbstractRepository<T> implements IBaseRepository<T> {
  private entity: Repository<T>;
  protected constructor(entity: Repository<T>) {
    this.entity = entity;
  }

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

产品仓库类 #

export type IProductsRepository = IBaseRepository<ProductsEntity>;

@Injectable()
export class ProductsRepository extends BaseAbstractRepository<ProductsEntity> implements IProductsRepository {
  constructor(@Inject(EDatabaseProviders.DATABASE_CONNECTION) readonly _dbConnection: DataSource) {
    super(_dbConnection.getRepository<ProductsEntity>(ProductsEntity));
  }
}

产品模块提供者 #

export enum EProductsProviders {
  VALUE = "VALUE",
  REPOSITORY = "REPOSITORY",
}

export const productsProviders: Array<Provider> = [
  {
    provide: EProductsProviders.VALUE,
    useValue: 32,
  },

  {
    provide: EProductsProviders.REPOSITORY,
    useClass: ProductsRepository,
  },
  ProductsRepository,
  ProductsService,
];

无循环引用的ProductsService #

@Injectable()
export class ProductsService {
  constructor(private readonly _repo: ProductsRepository) {} //<--- 使用类无错误

  async getAll(): Promise<TProductsDtoOutput[]> {
    const resu = await this._repo.findAll({
      relations: {
        transactions: true,
      },
    });

    return resu.map((r) => {
      const { id, ...rest } = r;
      return rest as TProductsDtoOutput;
    });
  }
}

触发循环引用的ProductsService #

@Injectable()
export class ProductsService {
  constructor(
@Inject(EProductsProviders.REPOSITORY) 
private readonly _repo: IProductsRepository) {} // <--- 错误：ProductsModule内检测到循环依赖
  
  async getAll(): Promise<TProductsDtoOutput[]> {
      const resu = await this._repo.findAll({
        relations: {
          transactions: true,
        },
      });
  
      return resu.map((r) => {
        const { id, ...rest } = r;
        return rest as TProductsDtoOutput;
      });
    }
}

产品模块 #

@Module({
  imports: [DatabaseModule, AuthenticationModule],
  controllers: [ProductsController],
  providers: [...productsProviders],
})

export class ProductsModule {}

问题原因分析 #

1. 重复注册导致DI解析混乱：productsProviders中同时注册了ProductsRepository类本身和通过EProductsProviders.REPOSITORY指向它的提供者，Nest的DI系统在解析依赖时，可能因重复的提供者条目形成闭环。
2. TypeScript接口类型擦除问题：TS编译后接口会被移除，Nest无法通过IProductsRepository类型识别依赖。当构造函数中同时声明接口类型和@Inject装饰器时，DI系统可能尝试基于残留的元数据解析，意外触发循环链。
3. 模块间隐式循环引用：ProductsModule导入的AuthenticationModule或DatabaseModule可能间接依赖ProductsModule内的服务（比如AuthenticationModule中的某个服务用到了ProductsService），在使用Token注入时，这种隐式循环被DI系统检测到。

解决方案 #

• 移除重复的提供者注册：删除productsProviders中的ProductsRepository条目，仅保留通过EProductsProviders.REPOSITORY的注册项，避免DI系统解析冲突。
• 简化依赖注入声明：构造函数中仅保留@Inject(EProductsProviders.REPOSITORY)装饰器，保持IProductsRepository类型声明即可（若仍有问题，可临时改为any验证是否为类型元数据导致的问题）。
• 检查模块间依赖链：排查AuthenticationModule和DatabaseModule的代码，确认是否有服务依赖ProductsService或ProductsRepository，若存在需调整模块导入结构（比如使用forwardRef延迟加载，或重构依赖关系）。

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