Flutter发布模式出现Classpath依赖版本不兼容但构建成功的问题

问题分析 #

从错误日志能明确看到，项目里同时混入了Kotlin 1.6.x和1.7.x版本的标准库依赖，且项目使用的Kotlin Gradle插件版本低于依赖的stdlib版本（期望元数据版本1.5.1，实际是1.7.1）。虽然当前能构建成功，但这种版本冲突会留下运行时稳定性隐患，比如API调用异常、反射失败等问题，必须修复。

解决方案 #

1. 统一项目Kotlin版本 #

修改Flutter项目中android/build.gradle文件，把Kotlin版本统一为依赖里最高的1.7.10，同时确保Gradle插件版本和Kotlin版本兼容：

buildscript {
    ext.kotlin_version = '1.7.10' // 统一对齐到1.7.10版本
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // 搭配与Kotlin 1.7.10兼容的Gradle插件版本，比如7.4.2
        classpath "com.android.tools.build:gradle:7.4.2"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

2. 强制所有依赖使用统一的Kotlin标准库 #

在android/app/build.gradle中添加依赖约束，强制所有第三方依赖对齐指定版本的Kotlin stdlib，从根源避免版本冲突：

dependencies {
    // 保留原有依赖配置
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"

    // 添加约束规则，强制所有依赖使用指定版本的Kotlin库
    constraints {
        implementation 'org.jetbrains.kotlin:kotlin-stdlib:1.7.10'
        implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.7.10'
        implementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.7.10'
        implementation 'org.jetbrains.kotlin:kotlin-stdlib-common:1.7.10'
    }
}

3. 清理缓存并重新构建 #

执行以下命令清理旧缓存，确保新配置完全生效：

flutter clean
cd android && ./gradlew clean build --refresh-dependencies
cd .. && flutter build apk --release

4. 排查第三方插件冲突 #

如果以上操作后仍有问题，检查pubspec.yaml中的第三方Flutter插件：

• 优先将插件更新到最新版本，新版插件通常会修复依赖版本适配问题
• 若某插件硬编码了旧版本Kotlin依赖，可在android/app/build.gradle中排除冲突依赖：

  dependencies {
      implementation("your_conflicting_plugin") {
          exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
      }
  }
  

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