为可多次注册的NestJS Store模块创建自定义Inject装饰器

我来帮你梳理下这个问题的核心和最优解决方案——你遇到的随机获取实例的问题，本质是全局模块下同名提供者（StoreService）被多次覆盖导致的。下面是几种更优雅的处理方式，既不需要依赖全局模块，又能实现按名称精准注入：

1. 为每个Store实例生成唯一提供者令牌 #

你之前尝试过用STORE_SERVICE_${name}做令牌，这个思路是对的，我们可以把它规范化：

首先定义一个生成唯一令牌的工具函数：

// store.constants.ts
export const getStoreServiceToken = (name: string) => `STORE_SERVICE_${name}`;

然后修改StoreModule的register方法，为每个实例注册带唯一令牌的StoreService，同时注入对应的名称：

import { Module, DynamicModule } from '@nestjs/common';
import { StoreService } from './store.service';
import { getStoreServiceToken } from './store.constants';

@Module({})
export class StoreModule {
  static register(name: string): DynamicModule {
    const storeToken = getStoreServiceToken(name);
    return {
      module: StoreModule,
      providers: [
        // 注册当前实例的名称标识
        { provide: 'STORE_NAME', useValue: name },
        // 为当前实例的StoreService绑定唯一令牌
        {
          provide: storeToken,
          useClass: StoreService,
          inject: ['STORE_NAME'], // 把名称注入到StoreService的构造函数
        },
      ],
      exports: [storeToken], // 导出带唯一令牌的服务，供其他模块使用
    };
  }
}

这样每个Store实例的服务都有独立的令牌，不会互相覆盖。

2. 封装@InjectStore装饰器简化注入 #

有了唯一令牌后，我们可以封装一个装饰器，让注入更简洁：

// store.decorators.ts
import { Inject } from '@nestjs/common';
import { getStoreServiceToken } from './store.constants';

export const InjectStore = (name: string) => Inject(getStoreServiceToken(name));

现在在其他服务中，就能精准注入指定名称的StoreService了：

import { Injectable } from '@nestjs/common';
import { InjectStore } from './store.decorators';
import { StoreService } from './store.service';

@Injectable()
export class PetsService {
  constructor(
    @InjectStore('cats') private readonly catsStore: StoreService,
    @InjectStore('dogs') private readonly dogsStore: StoreService,
  ) {}

  // 业务逻辑中就能分别操作两个不同的Store实例
}

3. 避免全局模块的更优实践 #

其实完全不需要把StoreModule设为全局，你可以在需要使用Store的业务模块中，分别导入对应的Store实例：

// cats.module.ts
import { Module } from '@nestjs/common';
import { CatsService } from './cats.service';
import { StoreModule } from '../store/store.module';

@Module({
  imports: [StoreModule.register('cats')], // 只导入cats对应的Store实例
  providers: [CatsService],
})
export class CatsModule {}

// dogs.module.ts
import { Module } from '@nestjs/common';
import { DogsService } from './dogs.service';
import { StoreModule } from '../store/store.module';

@Module({
  imports: [StoreModule.register('dogs')], // 只导入dogs对应的Store实例
  providers: [DogsService],
})
export class DogsModule {}

这种方式让每个业务模块只依赖自己需要的Store实例，完全避免了冲突，模块隔离性更好，也更符合NestJS的模块化设计理念。

核心总结 #

• 不要全局注册StoreModule：全局模块会把所有实例的提供者都放到根容器，同名提供者会被覆盖，这就是你遇到随机实例的根本原因。
• 用唯一令牌区分实例：每个Store实例的服务必须有独立的标识，确保注入时不会混淆。
• 明确指定注入令牌：通过自定义装饰器或@Inject(令牌)来获取对应实例，不要依赖默认的类令牌。

这样处理后，你就能精准按名称注入对应的StoreService，同时保持代码的清晰和可维护性。

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