Mac清理后Flutter项目构建失败，如何解决kotlin-android插件异常？

检查项目根目录build.gradle配置 #

项目根目录（非app模块下的build.gradle）必须先声明Android Gradle插件依赖，再引入Kotlin插件。确保文件结构如下：

buildscript {
    ext.kotlin_version = '1.9.0' // 版本需与Flutter兼容，可按需调整
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2' // Android Gradle插件版本需与Gradle版本匹配
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

可通过项目gradle/wrapper/gradle-wrapper.properties文件查看当前Gradle版本，确保AGP版本与之对应（例如Gradle 7.4对应AGP 7.4.x）：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip

清除Gradle缓存 #

终端执行命令删除全局Gradle缓存：

rm -rf ~/.gradle/caches/

回到项目目录执行：

flutter clean
flutter pub get

校验Android Studio Kotlin插件版本 #

打开Android Studio，进入Settings > Plugins，搜索Kotlin，确保插件已安装且版本与项目中ext.kotlin_version一致。版本不匹配时，可更新插件或调整项目内版本号。

重新同步并构建项目 #

在Android Studio点击右上角Sync Project with Gradle Files按钮，或终端执行：

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

验证Flutter环境完整性 #

终端执行以下命令，排查并补全缺失的Android组件：

flutter doctor

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