升级Flutter至3.27.1后构建APK失败，求解决方案

• 锁定Flutter官方适配的Kotlin版本
  Flutter 3.27.x系列官方推荐的Kotlin版本为1.9.20，不要盲目升级到Kotlin 2.x（当前Flutter对该版本适配不完善）。修改项目根目录下的build.gradle文件：

  buildscript {
    ext.kotlin_version = '1.9.20'
    // 其他原有配置保留
  }
  

• 统一所有Kotlin版本引用
  检查android/app/build.gradle，确保没有硬编码Kotlin版本，使用根目录定义的全局变量：

  plugins {
    id "com.android.application"
    id "kotlin-android"
    id "dev.flutter.flutter-gradle-plugin"
  }
  // 不要在此处单独指定kotlin版本号
  

• 彻底清理缓存，消除旧版本残留
  执行以下命令清理所有相关缓存：

  flutter clean
  rm -rf android/.gradle android/build
  # Windows用户手动删除C:\Users\<你的用户名>\.gradle\caches
  # Linux/macOS用户执行 rm -rf ~/.gradle/caches
  

• 匹配Gradle与Kotlin版本
  Kotlin 1.9.20需要Gradle 8.2及以上版本，修改android/gradle/wrapper/gradle-wrapper.properties中的distributionUrl：

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

• 强制同步并重新构建
  在IDE中执行File -> Sync Project with Gradle Files，然后在项目根目录运行构建命令：

  flutter build apk --release
  

• 排查第三方插件版本冲突
  若以上步骤无效，可能是第三方插件依赖旧版Kotlin。运行flutter pub deps查看依赖树，将可疑插件升级到最新版本；也可在android/build.gradle中强制统一Kotlin版本：

  subprojects {
    project.configurations.all {
      resolutionStrategy.eachDependency { details ->
        if (details.requested.group == 'org.jetbrains.kotlin' && details.requested.name.startsWith("kotlin-")) {
          details.useVersion '1.9.20'
        }
      }
    }
  }
  

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