NestJS环境下的熔断降级与接口依赖反转设计 - 第2节

2.1 使用 NestJS CLI 创建项目

NestJS 官方 CLI 是初始化项目最标准、最快速的方式。它自动生成 TypeScript 编译配置、ESLint 规则、测试框架以及推荐的目录骨架，让开发者从零配置中解放出来。

2.1.1 安装 CLI 与创建项目

# 全局安装 NestJS CLI
npm install -g @nestjs/cli

# 创建新项目（项目名：circuit-breaker-demo）
nest new circuit-breaker-demo

执行 nest new 后，CLI 会询问包管理器选择（npm / yarn / pnpm）。选择后自动完成依赖安装与 Git 初始化。

2.1.2 生成后的目录结构

circuit-breaker-demo/
├── src/
│   ├── app.controller.spec.ts   # 单元测试
│   ├── app.controller.ts        # 根控制器
│   ├── app.module.ts            # 根模块
│   ├── app.service.ts           # 根服务
│   └── main.ts                  # 应用入口
├── test/
│   ├── app.e2e-spec.ts          # 端到端测试
│   └── jest-e2e.json
├── .eslintrc.js
├── .prettierrc
├── nest-cli.json
├── package.json
├── tsconfig.build.json
└── tsconfig.json

2.2 模块化结构解析

NestJS 的模块化设计借鉴了 Angular 的模块系统，每个功能单元被封装在一个 @Module 装饰器中。模块是组织代码、管理依赖、控制作用域的最小单元。

2.2.1 模块的核心组成

2.2.2 模块的元数据属性

@Module({
  imports:      [],   // 导入其他模块，共享其导出的提供者
  controllers:  [],   // 注册本模块的控制器
  providers:    [],   // 注册本模块的服务/提供者
  exports:      [],   // 导出本模块的提供者，供其他模块使用
})
export class AppModule {}

2.3 依赖注入容器基础概念

NestJS 内置了强大的依赖注入（DI）容器。DI 容器负责实例化对象、管理生命周期、自动解析构造函数中的依赖关系。这是实现熔断降级与接口反转设计的核心基础设施。

2.3.1 依赖注入的工作流程

1. 注册提供者：在模块的 providers 数组中声明类或令牌。
2. 声明依赖：在构造函数中通过类型注解或 @Inject() 声明需要注入的依赖。
3. 容器解析：NestJS 运行时扫描构造函数参数，从容器中查找匹配的提供者实例。
4. 注入实例：容器将解析后的实例注入到构造函数中，完成对象组装。

2.3.2 提供者注册方式对比

2.3.3 依赖注入与接口反转的关系

在熔断降级场景中，我们经常需要为同一个接口提供多个实现（正常调用、熔断降级、缓存回退）。DI 容器通过自定义令牌和工厂提供者，可以在运行时动态选择注入哪个实现，从而实现接口依赖反转。

2.4 模块化结构与依赖注入关系图

下图展示了 NestJS 模块化结构中，DI 容器如何连接控制器、服务与模块之间的关系：

2.5 实战：创建第一个业务模块

使用 CLI 生成一个完整的订单模块，体验模块化结构与 DI 的配合：

# 生成模块
nest generate module order

# 生成控制器
nest generate controller order

# 生成服务
nest generate service order

执行后，src/ 目录下会新增 order/ 文件夹，包含以下文件：

src/order/
├── order.controller.ts
├── order.module.ts
└── order.service.ts

查看自动生成的 order.module.ts：

import { Module } from '@nestjs/common';
import { OrderController } from './order.controller';
import { OrderService } from './order.service';

@Module({
  controllers: [OrderController],
  providers:   [OrderService],
  exports:     [OrderService],  // 导出服务，供其他模块使用
})
export class OrderModule {}

在 AppModule 中导入 OrderModule：

import { Module } from '@nestjs/common';
import { OrderModule } from './order/order.module';

@Module({
  imports: [OrderModule],
})
export class AppModule {}

2.6 依赖注入与模块化对熔断降级的意义

理解 DI 容器和模块化结构是掌握熔断降级设计的前提：

• 接口抽象：通过自定义令牌 + 工厂提供者，可以为同一个接口注册多个实现（正常、降级、缓存）。
• 运行时切换：DI 容器支持在运行时重新绑定提供者，实现熔断状态变化时自动切换降级逻辑。
• 模块隔离：每个模块的 DI 容器作用域独立，熔断降级策略可以按模块粒度配置，互不干扰。
• 测试友好：DI 容器让单元测试中可以轻松注入 Mock 服务，验证熔断逻辑的正确性。