dependency-injection

Dependency Injection Skill — DI 模式

何时使用

• 设计模块化应用（让组件可测试 / 可替换）
• 选择手动 DI 还是用框架（NestJS / Spring / Inversify）
• 调试循环依赖
• 区分 singleton / scoped / transient 生命周期
• 评审 PR 中"new XXX()"是否合适

一、核心思想

依赖注入进来，不是依赖主动获取。

// ❌ 主动依赖（hard-coded）
class UserService {
  private db = new PostgresClient()                  // 改实现要改这
  private logger = console                            // 测试无法 mock
  getUser(id: string) { return this.db.query(...) }
}

// ✅ 依赖注入（构造器）
class UserService {
  constructor(private db: Database, private logger: Logger) {}
  getUser(id: string) {
    this.logger.info({ id }, 'fetching user')
    return this.db.query(...)
  }
}

// 调用方决定具体实现
const svc = new UserService(new PostgresClient(), pino())

收益：

1. 可测试：注入 fake / mock
2. 可替换：切 SQLite / Mock DB / Redis
3. 显式依赖：构造器签名是合同
4. 解耦：组件不知道依赖如何创建

二、何时不用 DI 框架

多数小项目不需要框架。手动 DI 在 composition root（main / 启动文件）一处装配就够：

// composition-root.ts
export function buildApp() {
  const db = new PostgresClient(env.DATABASE_URL)
  const logger = pino({ level: env.LOG_LEVEL })
  const cache = new RedisClient(env.REDIS_URL)
  const userRepo = new UserRepo(db)
  const userSvc = new UserService(userRepo, cache, logger)
  const authSvc = new AuthService(userRepo, logger, env.JWT_SECRET)
  // ...
  return { userSvc, authSvc }
}

只在以下情况上框架：

• 大量服务（> 30 个）相互依赖，手装配维护痛
• 需要按请求 scope 注入（NestJS / Spring Web）
• 团队习惯 / 框架要求（Spring Boot / NestJS / Angular）

三、四种注入方式

1. Constructor Injection（首选）

class Service {
  constructor(private db: Database) {}
}

依赖立即可见 / 不可变 / 强制必填。

2. Setter Injection（次选）

class Service {
  private db?: Database
  setDb(db: Database) { this.db = db }
}

适合可选依赖。但用前必须检查 null。

3. Property Injection（框架专用）

// NestJS
class Service {
  @Inject('DB') private db: Database
}

// Spring
@Autowired private Database db;

简洁但隐藏依赖（看不出有哪些）。

4. Method Injection（罕见）