Flutter构建APK遇Kotlin Gradle插件版本兼容问题求助

问题分析 #

报错核心是项目中部分依赖用Kotlin 1.8编译，但构建环境仍期望1.6版本的元数据，仅修改settings.gradle的插件版本不足以同步整个项目的配置。

具体解决方案 #

1. 统一App模块的Kotlin插件版本 #

打开android/app/build.gradle，确保kotlin-android插件版本与settings.gradle中一致，避免硬编码旧版本：

plugins {
    id 'com.android.application'
    id 'kotlin-android' // 无需指定版本，会继承settings.gradle中的全局配置
    id 'dev.flutter.flutter-gradle-plugin'
}

如果之前手动指定了版本，删除版本号，或者改为1.8.10。

2. 检查gradle.properties中的全局Kotlin版本配置 #

打开项目根目录的gradle.properties，查找是否存在强制指定Kotlin版本的配置，修改为与插件匹配的版本：

# 若存在以下配置，修改版本号
kotlin.version=1.8.10

3. 匹配AGP与Kotlin版本（关键） #

当前你使用的AGP版本是7.3.0，它与Kotlin 1.8.x兼容性不佳，建议升级AGP到对应版本：
打开android/settings.gradle，更新AGP版本：

plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "7.4.2" apply false // 升级到支持Kotlin 1.8.x的版本
    id "org.jetbrains.kotlin.android" version "1.8.10" apply false
}

AGP与Kotlin版本对应关系：AGP 7.4.x 适配 Kotlin 1.8.x；AGP 7.3.x 适配 Kotlin 1.7.x

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

执行以下命令彻底清理缓存，避免旧配置残留：

flutter clean
# Windows用户手动删除android/.gradle和项目根目录的.gradle文件夹
flutter pub get
flutter build apk

5. 更新依赖包到最新稳定版 #

执行命令更新所有Flutter依赖，确保WalletConnect/Web3Modal等包使用兼容最新Kotlin版本的版本：

flutter pub upgrade

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