Factory 容器库中关于重置后缓存失效问题的技术分析

问题背景

在使用 Factory 2.5.3 版本时，开发者发现了一个关于容器重置后缓存失效的问题。具体表现为：当使用自定义容器并设置默认作用域为.cached后，在容器重置后重新注册的服务无法保持缓存状态，每次解析都会创建新实例。

技术细节解析

自定义容器实现

典型的自定义容器实现如下：

public final class CustomContainer: SharedContainer {
    @TaskLocal public static var shared = CustomContainer()
    
    public let manager: ContainerManager = {
        let manager = ContainerManager()
        manager.defaultScope = .cached  // 设置默认缓存作用域
        #if DEBUG
        manager.trace = true  // 调试模式下启用追踪
        #endif
        return manager
    }()
}

这种实现方式通过属性初始化器设置默认作用域为缓存模式，期望所有注册的服务默认使用缓存实例。

服务注册与解析

服务注册通常采用以下模式：

extension CustomContainer {
    var userService: Factory<UserService> { self { fatalError() } }
}

这种技术利用了初始工厂解析到fatalError的方式，确保服务只有在显式注册后才能使用。注册后通过register方法提供具体实现：

CustomContainer.shared.userService.register { UserService() }

问题重现流程

1. 初始注册后，服务解析正常使用缓存
2. 调用reset(options: .all)重置容器
3. 重新注册相同服务
4. 再次解析时，每次都会创建新实例，缓存失效

问题根源分析

此问题源于 Factory 2.5.3 版本的一个重要变更：容器重置操作现在会同时重置defaultScope和promiseTriggersError等属性。这个变更的目的是确保reset操作能够真正重置所有容器状态。

在之前的版本(2.5.2)中，reset操作不会影响defaultScope设置。但在2.5.3中，由于reset会清除所有设置，而自定义容器中的defaultScope只在属性初始化时设置一次，导致重置后defaultScope恢复为默认值而非.cached。

解决方案

方案一：使用autoRegister

在容器中实现autoRegister方法，在其中设置默认作用域：

public func autoRegister() {
    manager.defaultScope = .cached
    #if DEBUG
    manager.trace = true
    #endif
}

这种方式会在每次容器初始化时自动调用，确保重置后作用域设置也能恢复。

方案二：自定义重置方法

对于更复杂的场景，可以创建自定义的重置方法：

public final class CustomContainer: SharedContainer {
    // ...其他代码...
    
    public init() {
        resetAndRestoreSettings()
    }

    public func resetAndRestoreSettings() {
        manager.reset(settings: .all)
        manager.defaultScope = .cached
        #if DEBUG
        manager.trace = true
        #endif
    }
}

这种方法提供了更大的灵活性，特别适合需要在不同阶段注册不同服务组的场景。

最佳实践建议

1. 明确作用域需求：在设计容器时，明确每个服务的生命周期需求，合理设置作用域
2. 重置策略规划：对于需要频繁重置的容器，提前规划好重置后的状态恢复策略
3. 版本升级检查：升级Factory版本时，特别注意与容器重置相关的变更
4. 调试工具利用：充分利用Factory提供的trace功能，在调试阶段跟踪服务解析过程

总结

Factory 2.5.3版本对容器重置行为的修改带来了更彻底的清理机制，但也需要开发者调整自定义容器的实现方式。通过本文介绍的两种解决方案，开发者可以根据具体场景选择最适合的方式来保证容器重置后缓存机制的正常工作。理解这一机制对于构建稳定可靠的依赖注入系统至关重要。