Flutter升级至3.19.5后Android真机构建失败求助

1. 强制统一所有模块的Kotlin版本 #

你虽然在android/build.gradle里配置了ext.kotlin_version='1.9.24'，但第三方依赖可能偷偷引入了1.6.0这类旧版本，导致版本冲突。在android/build.gradle的allprojects块中添加以下代码，强制所有模块使用指定的Kotlin版本：

allprojects {
    repositories {
        // 保留你原有的仓库配置
    }
    // 新增版本统一逻辑
    configurations.all {
        resolutionStrategy {
            eachDependency { details ->
                if (details.requested.group == 'org.jetbrains.kotlin') {
                    details.useVersion '1.9.24'
                }
            }
        }
    }
}

2. 配套升级Gradle与Android Gradle Plugin（AGP） #

Kotlin 1.9.24需要对应版本的Gradle支持，否则项目无法正常识别：

• 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl为兼容版本，例如：

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

• 回到android/build.gradle，确保AGP版本与Kotlin、Gradle匹配，示例配置：

  dependencies {
      classpath 'com.android.tools.build:gradle:8.2.2'
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  }
  

  （Kotlin 1.9.x推荐搭配AGP 8.0+、Gradle 8.0+版本）

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

缓存残留很容易引发异常，按以下步骤清理后重试：

• 执行命令：flutter clean
• 删除Android端缓存目录：android/.gradle、android/build
• 重启Android Studio，选择File > Invalidate Caches... > Invalidate and Restart
• 重新尝试真机构建或打Release包

4. 检查第三方Flutter依赖 #

部分老旧插件可能内置了旧版Kotlin配置，执行flutter pub deps查看依赖树，找到引入旧Kotlin版本的插件：

• 优先升级该插件到最新版本
• 如果是本地自定义插件，直接修改其build.gradle中的Kotlin版本为1.9.24

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