什么是自定义提供者和注入令牌?

Question

什么是自定义提供者和注入令牌?

Accepted Answer

除了简单的 `@Injectable()` 类之外，NestJS 还支持 **自定义提供者** ——使用 **注入令牌** 定义要注入内容的灵活方式。这让你可以注入值、配置如何创建实例、交换实现，以及注入非类依赖项。

## 四种自定义提供者类型

```ts
@Module({
  providers: [
    // 1. useClass — standard (or swap the implementation behind a token)
    { provide: PaymentService, useClass: StripePaymentService },

// 2. useValue — inject a constant/object/mock (great for config and testing)
    { provide: "CONFIG", useValue: { apiKey: "abc", timeout: 5000 } },

// 3. useFactory — compute the provider dynamically (can use other deps)
    {
      provide: "DATABASE_CONNECTION",
      useFactory: async (config: ConfigService) => {
        return await createConnection(config.get("DB_URL"));   // async setup
      },
      inject: [ConfigService],        // dependencies for the factory
    },

// 4. useExisting — create an alias for an existing provider
    { provide: "ALIAS", useExisting: PaymentService },
  ],
})
export class AppModule {}
```

## 注入令牌——用于非类依赖项

```ts
// classes can be tokens directly (by type). For values/interfaces, use a string/Symbol token:
@Injectable()
export class PaymentProcessor {
  constructor(@Inject("CONFIG") private config: AppConfig) {}   // inject by token
}
```

由于无法按类型注入接口或普通值（它们在运行时不存在），所以使用 **令牌**（字符串或 `Symbol`）配合 `@Inject(token)` 来注入它。这是注入配置对象、第三方客户端或接口类型依赖项的方式。

## useFactory——最强大的（动态、异步设置）

```ts
// create a provider whose value depends on runtime config / async initialization
{
  provide: "REDIS_CLIENT",
  useFactory: (config: ConfigService) => new Redis(config.get("REDIS_URL")),
  inject: [ConfigService],
}
```

`useFactory` 运行一个函数（带有注入的依赖项）来生成提供者——对于连接、客户端或任何需要运行时配置或异步设置的内容都是必需的。

## 交换实现（useClass）——灵活性和测试

```ts
// inject a different implementation based on environment
{
  provide: PaymentService,
  useClass: process.env.NODE_ENV === "test" ? MockPaymentService : StripePaymentService,
}
```

由于消费者依赖令牌（`PaymentService`），你可以交换具体类——生产环境中使用真实的 Stripe 服务，测试中使用模拟版本——无需改动任何消费者代码。

## 为什么这很重要

自定义提供者和注入令牌将 NestJS 的依赖注入扩展到简单类之外，为真实应用程序提供所需的灵活性。

理解它们对几个常见场景很重要：**注入非类值**（配置对象、常量）通过 `useValue` 和字符串/Symbol 令牌（因为无法按类型注入接口或普通值）；**动态/异步提供者创建**通过 `useFactory`（最强大的形式——创建数据库连接、Redis 客户端或第三方 SDK 实例，由运行时值配置，具有自己的注入依赖项）；以及**交换实现**通过令牌后面的 `useClass`（启用基于环境的实现，至关重要的是，在测试中轻松**模拟**——为令牌提供模拟类，无需触及消费者）。

这种灵活性正是使 NestJS 的 DI 对生产架构强大、对可测试性优秀的原因。

了解四种提供者类型（`useClass`、`useValue`、`useFactory`、`useExisting`）、注入令牌如何用于非类依赖项，以及何时使用每一种——这是超越基础 DI 的重要一步——这就是你如何以 NestJS 习用方式连接数据库、外部服务、配置以及可交换/可模拟依赖项，使其成为真实应用程序中经常需要、架构上重要的主题。