PAYATHON 2026

Koin Compiler Plugin 如何迁移 single lambda 而不使用注解？

数据小陈

可以保留 single { get<AppDatabase>().itemDao() }，无需改成 @Module 和 @Single。Koin Compiler Plugin 支持 DSL，接入插件后仍可使用非注解写法。官方文档也允许在同一项目中混用 Compiler Plugin DSL 和 Classic DSL。官方写法说明

直接保留现有定义

通过数据库实例取得 DAO 时，可以保留原来的 lambda：

import org.koin.dsl.module

val databaseModule = module {
    // 保留现有的 AppDatabase 注册代码
    single<ItemDao> { get<AppDatabase>().itemDao() }
}

这里假设 itemDao() 返回 ItemDao。显式写出 <ItemDao> 便于阅读，也可以保留原来的类型推断写法。确保 AppDatabase 已注册，相关模块也已加载。

single<ItemDao>() 通常不能直接替代这段代码。这种简写由插件根据构造函数生成实例，而当前代码需要调用 AppDatabase.itemDao()；单凭 ItemDao 类型无法表达这条创建路径。Compiler Plugin 工作原理

希望自动解析 provider 参数时使用 create

如果希望把创建逻辑提取成函数，并省去手写 get()，可以在支持该 API 的插件版本中使用 create(::function)：

import org.koin.dsl.module
import org.koin.plugin.module.dsl.create

fun provideItemDao(appDatabase: AppDatabase): ItemDao =
    appDatabase.itemDao()

val databaseModule = module {
    // 保留现有的 AppDatabase 注册代码
    single { create(::provideItemDao) }
}

这个函数不需要注解。插件根据 provideItemDao 的参数解析 AppDatabase，再调用函数取得 ItemDao。官方文档也提供了同类的函数引用用法。函数 provider 的编译检查

迁移时注意版本和检查范围

原问题没有提供版本。以上插件用法依据 Koin 4.2 官方文档，接入前应核对项目的 Koin、Kotlin 与插件版本是否兼容，并在声明相关定义的 Gradle 模块中应用插件。create(::provideItemDao) 需要插件处理，仅添加 import 不够。插件配置说明

官方文档说明，自 Compiler Plugin 1.2.0 起，现有 Classic DSL 中的依赖获取调用也可获得编译期检查。对于手写 lambda，检查 get<AppDatabase>() 等依赖调用，并不等于验证 itemDao() 内部的所有行为；仍需验证数据库和 DAO 的实际使用是否正常。检查范围说明

备注：内容仅供参考。