正确配置Koin Context Isolation避免偶发NoBeanDefFoundException

根因分析 #

随机崩溃的根本原因是Koin初始化时机和ViewModel委托取值时机的顺序不确定：

• 类属性通过by viewModel()声明的ViewModel委托为懒加载机制，首次访问时才会触发实例化
• Koin初始化放在了Activity.onCreate的执行流程中，部分场景下（比如Activity配置变更重建、系统恢复页面状态），ViewModel的取值逻辑会早于Koin初始化代码执行
• 如果接入的App自身初始化了全局Koin实例，此时会优先从全局Koin容器中查找ViewModel，找不到就抛出NoBeanDefFoundException；如果宿主没有全局Koin，还会触发lateinit未初始化异常

可行方案 #

方案1：提供公开初始化接口（最稳妥） #

对外暴露SDK初始化方法，要求接入方在自身Application.onCreate中调用，保证Koin在所有组件启动前完成初始化：

// SDK内部的初始化入口
object MySdkInitializer {
    fun init(context: Context) {
        // 防止重复初始化
        if (::LocalKoinContext.koinApplication.isInitialized) return
        LocalKoinContext.koinApplication = koinApplication {
            androidLogger(Level.ERROR)
            androidContext(context.applicationContext)
            androidFileProperties()
            modules(theModule)
        }
    }
}

该方案逻辑最可控，不会有顺序问题，仅需要在接入文档中说明初始化要求即可。

方案2：无侵入初始化（接入成本最低） #

ContentProvider的onCreate执行时机早于Application.onCreate，是Android官方推荐的SDK无侵入初始化方案，完全不存在初始化顺序问题，且实现成本极低，并不“重”：
可以直接用AndroidX Startup库封装初始化逻辑，无需手动编写ContentProvider，仅需要添加依赖、声明初始器即可：

1. 在build.gradle中添加Startup依赖
2. 实现Initializer接口：

class KoinInitializer : Initializer<Unit> {
    override fun create(context: Context) {
        MySdkInitializer.init(context)
    }

    override fun dependencies(): MutableList<Class<out Initializer<*>>> = mutableListOf()
}

3. 在AndroidManifest中注册Initializer即可。
   该方案不需要接入方做任何额外配置，和直接写ContentProvider的效果一致，稳定性有保障，大量官方组件（WorkManager、Lifecycle等）都用该机制实现初始化。

方案3：调整Activity内的初始化和ViewModel取值逻辑 #

如果一定要在Activity内完成初始化，需要修改两处逻辑：

1. 将Koin初始化代码移到super.onCreate之前执行
2. 不要使用默认的by viewModel()委托，改为显式从本地Koin实例获取ViewModel：

class FirstActivity : AppCompatActivity(), CustomKoinComponent {

    private lateinit var sharedViewModel: MySharedViewModel

    override fun onCreate(savedInstanceState: Bundle?) {
        // 先初始化Koin，再调用super.onCreate
        LocalKoinContext.koinApplication = koinApplication {
             androidLogger(Level.ERROR)
             androidContext(applicationContext)
             androidFileProperties()
             modules(theModule)
         }
        super.onCreate(savedInstanceState)
        // 初始化完成后再获取ViewModel
        sharedViewModel = getViewModel()
    }
}

额外注意事项 #

请确认Koin模块中已经正确注册了MySharedViewModel，示例如下：

val theModule = module {
    viewModel<MySharedViewModel>()
}

内容的提问来源于stack exchange，提问作者Dude