理解tsyringe中容器作用域与单例模式的区别

tsyringe是一个流行的依赖注入容器，广泛应用于TypeScript项目中。本文将深入探讨tsyringe中容器作用域(ContainerScoped)与单例模式(Singleton)的关键区别，以及如何正确使用它们来实现多租户场景下的依赖隔离。

问题背景

在开发多租户系统时，我们经常需要为不同的租户提供相同的服务接口，但底层实现需要根据租户进行隔离。例如，不同公司可能使用相同API的不同实例，只是基础URL不同。这种情况下，我们希望每个租户有自己的服务实例，彼此互不干扰。

错误的使用方式

很多开发者会像下面这样尝试使用tsyringe：

const childContainerA = container.createChildContainer()
childContainerA.registerInstance(BasicService, new BasicService('A'))

const childContainerB = container.createChildContainer()
childContainerB.registerInstance(BasicService, new BasicService('B'))

const highLevelServiceA = childContainerA.resolve(HighLevelService)
const highLevelServiceB = childContainerB.resolve(HighLevelService)

他们期望HighLevelService会分别使用对应子容器中的BasicService，但实际上两个HighLevelService实例是同一个，都使用了第一个解析到的BasicService。

根本原因

问题出在@singleton()装饰器的行为上。在tsyringe中：

1. @singleton()表示全局单例，无论从哪个子容器解析，都会返回同一个实例
2. 单例实例会在第一次解析时创建，并缓存到根容器中
3. 后续所有解析请求，无论来自哪个子容器，都会返回这个缓存的实例

正确解决方案

要实现每个子容器有自己的实例，应该使用@containerScoped()装饰器：

@injectable()
@containerScoped()
class HighLevelService {
  constructor(@inject(BasicService) private readonly basicService: BasicService) {}
}

这样修改后：

1. 每个子容器会创建并缓存自己的HighLevelService实例
2. 从子容器A解析的HighLevelService会使用子容器A注册的BasicService
3. 从子容器B解析的HighLevelService会使用子容器B注册的BasicService

生命周期对比

理解tsyringe中的三种生命周期很重要：

1. Transient(瞬时): 每次解析都创建新实例
2. Singleton(单例): 整个应用生命周期内只有一个实例
3. ContainerScoped(容器作用域): 每个容器有自己的实例

实际应用建议

在多租户系统中，推荐的做法是：

1. 为每个租户创建子容器
2. 在子容器中注册租户特定的服务
3. 将业务服务标记为@containerScoped()
4. 根据请求的租户信息选择对应的子容器解析服务

这种方式确保了不同租户的服务完全隔离，同时避免了在每个服务方法中手动检查租户信息的繁琐代码。

总结

正确理解和使用tsyringe的生命周期管理对于构建可维护的多租户系统至关重要。记住关键区别：单例是全局唯一的，而容器作用域的实例是每个容器唯一的。在设计服务时，根据实际需求选择适当的生命周期，可以避免许多微妙的依赖注入问题。