You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter执行assembleRelease构建APK出现Kotlin版本不兼容警告如何解决

问题根因

Gradle的依赖版本仲裁机制已经将所有实际参与打包的Kotlin依赖统一到1.5.10版本,该警告属于Kotlin编译器的类路径扫描逻辑触发:编译器会扫描所有依赖声明关联的本地缓存Jar包,即使这些旧版本Jar最终不会被打包,也会触发版本不一致的告警。

修复方案
  • 方案1:显式强制指定所有Kotlin依赖版本
    在项目顶层build.gradle文件中添加全局版本仲裁规则,配置如下:
allprojects {
    repositories {
        google()
        jcenter()
    }
    // 新增全局依赖版本统一规则
    configurations.all {
        resolutionStrategy {
            eachDependency { DependencyResolveDetails details ->
                if (details.requested.group == 'org.jetbrains.kotlin') {
                    details.useVersion "1.5.10"
                }
            }
        }
    }
}
  • 方案2:清理缓存后重新构建
    执行以下命令清理旧的构建缓存和依赖缓存,再重新执行打包命令:
flutter clean
./gradlew clean
# Windows环境替换为 gradlew clean
  • 方案3:抑制告警(可选)
    如果确认依赖版本无问题,可在app/build.gradle的kotlin配置中添加编译参数直接抑制该类警告:
android {
    // 其他配置省略
    kotlinOptions {
        jvmTarget = '1.8'
        freeCompilerArgs += ["-Xignore-runtime-version-conflict"]
    }
}
潜在风险说明
  • 从提供的依赖树来看,所有Kotlin依赖已经被向上统一到1.5.10版本,Kotlin本身具备完善的向下兼容性,不会出现运行时类找不到、方法签名不匹配等异常,该告警几乎不会影响APK的正常运行。
  • 只有当强制指定的Kotlin版本低于第三方依赖编译使用的Kotlin版本时,才可能出现运行时兼容问题,当前场景下不存在该风险。

内容的提问来源于stack exchange,提问作者jbx

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.04 08:36:04