KMP支付SDK集成Koin遇兼容问题：无Koin时应用崩溃求助

核心问题分析 #

你遇到的崩溃本质是SDK代码直接引用了Koin类，导致客户端未集成Koin时触发ClassNotFoundException/NoClassDefFoundError。Shadow插件的重定位没生效，大概率是因为Android库默认打aar，而ShadowJar默认生成jar，重定位后的Koin类没被合并到最终的aar中；同时直接调用Koin代码的逻辑没有被隔离，类加载阶段就会报错。

下面分步骤给出可落地的解决方法：

一、修复Gradle配置：正确处理Koin依赖与重定位 #

根据你的需求选择两种配置方案：

方案1：SDK自带独立的重定位Koin（客户端无Koin时SDK自行使用） #

如果需要SDK在客户端无Koin时也能自己用Koin，必须把重定位后的Koin类打包进aar：

plugins {
    id("com.android.library")
    kotlin("android")
    id("com.github.johnrengelman.shadow") version "7.1.2" // 用兼容Android的版本
}

android {
    // 你的Android基础配置（compileSdk、defaultConfig等）
    libraryVariants.all { variant ->
        // 为每个变体创建Shadow任务，重定位Koin包
        val shadowTask = tasks.create("shadow${variant.name.capitalize()}Jar", com.github.jengelman.gradle.plugins.shadow.tasks.ShadowJar::class.java) {
            archiveClassifier.set("shadow")
            from(variant.javaCompileProvider.get().destinationDir)
            configurations = listOf(variant.compileConfiguration)
            relocate("io.insert-koin", "com.your.sdk.shadowed.io.insert-koin") // 替换成你的SDK包名
        }
        // 将重定位后的class文件合并到aar的classes目录
        variant.outputs.all { output ->
            copy {
                from(shadowTask.archiveFile)
                into("${buildDir}/intermediates/aar_main_jar/${variant.name}")
                include("**/*.class")
            }
        }
    }
}

dependencies {
    commonMainImplementation("io.insert-koin:koin-core:3.3.0")
    androidMainImplementation("io.insert-koin:koin-android:3.3.0")
    // 其他SDK依赖...
}

方案2：SDK仅依赖客户端的Koin（无Koin时完全不触发相关逻辑） #

如果只需要在客户端有Koin时才使用，用compileOnly避免强制引入Koin：

dependencies {
    commonMainCompileOnly("io.insert-koin:koin-core:3.3.0")
    androidMainCompileOnly("io.insert-koin:koin-android:3.3.0")
    // 其他SDK依赖...
}

二、隔离Koin逻辑：动态检测+反射调用 #

无论哪种配置，都必须避免在SDK主流程中直接引用Koin类，通过反射延迟加载相关逻辑：

1. 实现Koin存在性检测 #

object KoinDetector {
    fun isKoinAvailable(): Boolean {
        return try {
            // 方案1（自带重定位Koin）：用重定位后的类名
            Class.forName("com.your.sdk.shadowed.io.insert-koin.core.KoinApplication")
            // 方案2（依赖客户端Koin）：用原始类名
            // Class.forName("io.insert-koin.core.KoinApplication")
            true
        } catch (e: ClassNotFoundException) {
            false
        } catch (e: NoClassDefFoundError) {
            false
        }
    }
}

2. 把Koin相关逻辑封装到单独类 #

将所有Koin初始化、注入逻辑放到独立类中，不要在SDK主类中直接引用：

// KoinIntegration.kt - 仅包含Koin相关代码
class KoinIntegration {
    fun initSDKWithKoin() {
        // 你的Koin初始化逻辑，比如：
        startKoin {
            androidContext(SDKContextHolder.get())
            modules(sdkDependencyModule)
        }
    }

    private val sdkDependencyModule = module {
        // SDK需要注入的依赖
        single<PaymentService> { DefaultPaymentService() }
    }
}

3. 在SDK主流程中动态触发 #

fun initSDK() {
    if (KoinDetector.isKoinAvailable()) {
        try {
            // 反射实例化KoinIntegration并执行逻辑
            val integrationClass = Class.forName("com.your.sdk.KoinIntegration")
            val instance = integrationClass.getDeclaredConstructor().newInstance()
            integrationClass.getMethod("initSDKWithKoin").invoke(instance)
        } catch (e: Exception) {
            // 处理反射异常（比如Koin版本不兼容）
            e.printStackTrace()
        }
    } else {
        // 客户端无Koin，走SDK内部DI流程
        initInternalDependencySystem()
    }
}

// SDK内部的非Koin依赖实现
private fun initInternalDependencySystem() {
    PaymentServiceHolder.set(DefaultPaymentService())
    // 其他内部依赖初始化
}

三、关键注意事项 #

• 禁止在静态变量、伴生对象中直接引用Koin类，否则类加载阶段就会崩溃
• 测试时分别验证两种场景：客户端无Koin时正常运行，客户端有Koin时SDK能正确集成
• 若选择方案1（自带重定位Koin），确保客户端的Koin与SDK的重定位Koin完全隔离，不会出现版本冲突

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