Flutter升级至3.13.x遇Android Gradle插件版本不兼容问题求助

核心问题定位 #

你的问题是desktop_drop依赖的Kotlin Gradle插件版本（1.5.20）低于AGP要求的1.6.20+，新项目能正常构建是因为Flutter 3.13.x默认Gradle配置会统一管理依赖版本，而旧项目的配置可能存在版本锁定或未正确继承默认规则。

正确的Gradle升级与版本统一步骤 #

1. 统一项目级Kotlin版本 #

在android/build.gradle的buildscript块中，明确指定符合要求的Kotlin版本（建议使用Flutter 3.13.x默认的1.8.20）：

buildscript {
    ext.kotlin_version = '1.8.20'
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath "com.android.tools.build:gradle:7.4.2" // 与Flutter 3.13.x适配的AGP版本
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

2. 强制子模块使用统一Kotlin版本 #

在android/build.gradle的allprojects块中添加版本强制规则，覆盖依赖库自带的旧版本：

allprojects {
    repositories {
        google()
        mavenCentral()
    }
    configurations.all {
        resolutionStrategy {
            force "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
            force "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        }
    }
}

3. 更新Gradle Wrapper版本 #

修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl，使用与AGP 7.4.2匹配的Gradle版本：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip

4. 清理缓存并重建项目 #

执行以下命令彻底清除缓存后重新构建：

flutter clean
cd android
./gradlew clean
./gradlew build --refresh-dependencies
cd ..
flutter run

5. 升级依赖包（可选） #

检查stream_chat_flutter是否有更新版本，新版本可能已修复依赖的Kotlin版本问题：

# pubspec.yaml
dependencies:
  stream_chat_flutter: ^latest_stable_version # 替换为实际最新稳定版

验证方式 #

执行flutter doctor -v确认Gradle与Kotlin版本匹配，或通过./gradlew dependencies查看kotlin-gradle-plugin的版本是否已统一为指定版本。

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