能否让NestJS将相同注入令牌的多Provider导入判定为错误？

问题描述 #

我有一个服务的两个实现，分别用于开发和生产环境，代码如下：

@Module({
  providers: [
    {
      provide: 'MyService',
      useClass: ProdMyService,
    }
  ],
  exports: ['MyService'],
})
export class ProdModule { }

@Module({
  providers: [
    {
      provide: 'MyService',
      useClass: DevMyService,
    }
  ],
  exports: ['MyService'],
})
export class DevModule { }

@Module({
  controllers: [MyController],
  imports: [ProdModule, DevModule],
})
export class AppModule { }

class MyController {
  constructor(@Inject('MyService') private readonly service: MyServiceInterface) { }
}

当前NestJS会选择其中一个MyService实现并忽略另一个，请问能否让NestJS将这种存在注入歧义的模块导入情况判定为错误？

解决方案 #

可以实现，有两种可行思路：

1. 主动检测重复提供者并抛出错误 #

利用NestJS的模块生命周期钩子onModuleInit，结合Injector API在应用启动时检查容器中是否存在重复的提供者token，一旦发现就抛出错误终止启动：

import { Module, OnModuleInit, Injector } from '@nestjs/common';

@Module({
  controllers: [MyController],
  imports: [ProdModule, DevModule],
})
export class AppModule implements OnModuleInit {
  constructor(private readonly injector: Injector) {}

  async onModuleInit() {
    const providers = this.injector.getProviders();
    const tokenOccurrences = new Map<string | symbol, number>();

    providers.forEach(provider => {
      const token = provider.token;
      tokenOccurrences.set(token, (tokenOccurrences.get(token) || 0) + 1);
    });

    const duplicateTokens = Array.from(tokenOccurrences.entries())
      .filter(([_, count]) => count > 1)
      .map(([token]) => token.toString());

    if (duplicateTokens.length) {
      throw new Error(`检测到重复的提供者Token：${duplicateTokens.join(', ')}`);
    }
  }
}

这样只要同时导入两个冲突模块，应用启动时就会直接报错，不会默默覆盖提供者。

2. 从根源避免歧义（官方推荐） #

不要同时导入生产和开发模块，而是根据环境变量动态选择要导入的模块，从根本上杜绝冲突：

const activeModule = process.env.NODE_ENV === 'production' ? ProdModule : DevModule;

@Module({
  controllers: [MyController],
  imports: [activeModule],
})
export class AppModule {}

这种方式符合NestJS的环境配置最佳实践，既避免了注入歧义，也让环境切换更清晰可控。

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