如何向Koin模块中的single{}传递动态参数配置Retrofit？

问题场景 #

当前项目使用Koin管理依赖，初始化Retrofit的代码如下：

single<ApiService> {
    Retrofit.Builder()
        .baseUrl("https://myurl.es")
        .addConverterFactory(JacksonConverterFactory.create())
        .addConverterFactory(ScalarsConverterFactory.create())
        .build()
        .create(ApiService::class.java)
}

需求是允许用户通过文本框修改baseUrl，需要用动态传入的变量初始化Retrofit单例，不想使用factory或字段注入的复杂实现。

简单实现方案 #

1. 定义可修改的配置类 #

创建一个用于存储baseUrl的配置类，通过Koin注册为全局单例，方便后续修改和获取：

class ApiConfig {
    // 默认baseUrl，可随时修改
    var baseUrl: String = "https://myurl.es"
}

// 在AppModule中注册该配置类
single { ApiConfig() }

2. 修改ApiService的Koin配置 #

调整ApiService的单例定义，依赖上述ApiConfig类来获取baseUrl：

single<ApiService> {
    // 从Koin中获取配置实例
    val apiConfig = get<ApiConfig>()
    Retrofit.Builder()
        .baseUrl(apiConfig.baseUrl)
        .addConverterFactory(JacksonConverterFactory.create())
        .addConverterFactory(ScalarsConverterFactory.create())
        .build()
        .create(ApiService::class.java)
}

3. 修改baseUrl并更新Retrofit实例 #

当用户在文本框输入新的baseUrl后，执行以下步骤：

// 1. 更新配置类中的baseUrl
val apiConfig = get<ApiConfig>()
apiConfig.baseUrl = userInputNewUrl

// 2. 删除Koin中已存在的ApiService单例
getKoin().delete<ApiService>()

// 3. 后续获取ApiService时，Koin会自动用新的baseUrl创建新实例
val updatedApiService = get<ApiService>()

原理说明 #

• ApiConfig作为全局单例，存储当前生效的baseUrl，支持随时修改。
• ApiService的单例是懒加载的，首次获取时会根据当时的ApiConfig.baseUrl创建实例。
• 当baseUrl修改后，通过delete<ApiService>移除旧实例，下次获取时Koin会重新执行创建逻辑，使用新的baseUrl生成实例。

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