Koin Android Compose 中 ViewModel 工厂在版本升级后的问题分析

问题背景

在 Koin Android Compose 项目中，当开发者从 koin-androidx-compose 3.5.0 版本升级到 3.5.3 或 3.5.4 版本后，自动化测试开始出现失败情况。具体表现为在执行多个测试用例时，第二个测试用例会抛出 Scope 'root' is closed 的异常。

错误现象

测试失败时抛出的典型错误堆栈如下：

Caused by: org.koin.core.error.ClosedScopeException: Scope '_root_' is closed
        at org.koin.core.scope.Scope.resolveInstance(Scope.kt:224)
        at org.koin.core.scope.Scope.get(Scope.kt:213)
        at org.koin.androidx.viewmodel.factory.KoinViewModelFactory.create(KoinViewModelFactory.kt:25)

问题根源分析

经过深入调查，发现问题出在 Koin 的 Scope 管理和 Compose 的本地组合之间的交互上：

1. Scope 生命周期问题：在测试环境中，Koin 的根 Scope 在第一个测试用例结束后被关闭，但后续测试用例尝试使用时，这个 Scope 已经不可用。

2. Compose 本地状态保留：LocalKoinScope 这个本地组合状态在测试用例之间没有被正确重置，导致后续测试用例仍然尝试使用已经关闭的 Scope。

3. ViewModel 工厂依赖：KoinViewModelFactory 在创建 ViewModel 实例时，依赖于当前活动的 Koin Scope，当 Scope 关闭后就会抛出异常。

技术细节

在 Compose 环境中，Koin 使用 LocalKoinScope 来管理当前的 Scope 上下文。这个本地状态在测试环境中表现出以下行为：

• 第一个测试用例执行时，Scope 被正确初始化和使用
• 测试用例结束后，Scope 被关闭
• 第二个测试用例开始执行时，Compose 的本地状态仍然保留着已关闭的 Scope 引用
• 当尝试创建 ViewModel 时，工厂方法访问了已关闭的 Scope，导致异常

临时解决方案

对于遇到此问题的开发者，可以考虑以下临时解决方案：

1. 显式指定 Scope：

viewModel = koinViewModel(
    scope = KoinPlatformTools.defaultContext().get().scopeRegistry.rootScope
)

2. 使用 KoinContext 包装：

setContent {
    KoinContext(context = KoinPlatformTools.defaultContext().get()) {
        // 你的Compose组件树
    }
}

3. 保持使用 3.5.0 版本：如果项目不急需新版本功能，可以暂时停留在 3.5.0 版本。

长期解决方案

Koin 团队已经意识到这个问题，并在后续版本中进行了修复。建议开发者关注官方更新，及时升级到包含修复的版本。

最佳实践建议

1. 在编写测试时，确保每个测试用例都有独立的 Koin 环境
2. 考虑使用 KoinTestRule 来管理测试生命周期
3. 对于 Compose 测试，特别注意本地状态的清理
4. 在升级依赖时，先在测试环境中验证兼容性

这个问题展示了依赖注入框架与声明式UI框架结合时可能出现的复杂交互问题，提醒我们在架构设计时需要特别注意生命周期管理和状态隔离。