如何解决Flutter打包时「项目需更新Kotlin Gradle插件」报错？

以下是几个能彻底解决这个问题的实操步骤：

• 同步Kotlin与Gradle版本
  只修改ext.kotlin_version不够，Kotlin插件和Gradle版本必须匹配：

  1. 打开项目根目录下的android/build.gradle，将ext.kotlin_version设为稳定版（比如1.9.20）
  2. 打开android/gradle/wrapper/gradle-wrapper.properties，更新distributionUrl到对应版本：
     • Kotlin 1.8.x对应Gradle 7.5+，例如gradle-7.5-all.zip
     • Kotlin 1.9.x对应Gradle 8.0+，例如gradle-8.2-all.zip

• 清理缓存后重新构建
  旧缓存可能导致版本配置不生效，执行以下命令：

  flutter clean
  cd android
  gradlew clean  # Windows系统用此命令，Mac/Linux用./gradlew clean
  cd ..
  flutter build appbundle
  

• 排查第三方依赖冲突
  部分Flutter插件可能自带旧版Kotlin插件，引发版本冲突：

  1. 进入android目录执行gradlew androidDependencies查看依赖树，找出携带旧版Kotlin的插件
  2. 要么升级该插件的pub版本，要么在android/build.gradle的buildscript里强制锁定Kotlin版本：

     buildscript {
         ext.kotlin_version = '1.9.20'
         repositories {
             google()
             mavenCentral()
         }
         dependencies {
             classpath "com.android.tools.build:gradle:7.4.2"
             classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
         }
     }
     

  3. 确保android/app/build.gradle里正确引用Kotlin插件：apply plugin: 'kotlin-android'

• 匹配Android Studio的Kotlin插件
  打开Android Studio设置，进入Languages & Frameworks → Kotlin Plugin，检查插件版本是否和项目中配置的kotlin_version一致，不一致则更新插件。

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