运行Flutter首个Demo报Failed to apply FlutterPlugin错误如何解决

API 探路者

2026-10-1

问题解决方案

该报错通常由Flutter与Android Gradle插件版本不兼容、gradle配置错误两类原因导致，可按以下步骤逐一排查修复：

步骤1：匹配Gradle插件与Flutter版本
打开项目根目录下android/build.gradle文件，找到dependencies块中的Gradle插件配置，确保版本与当前使用的Flutter版本适配：
Flutter 3.13+ 稳定版建议使用com.android.tools.build:gradle:7.4.0，不要使用8.0及以上的高版本Gradle插件。
配置示例：
```
dependencies {
    classpath 'com.android.tools.build:gradle:7.4.0'
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
```
步骤2：匹配Gradle分发版本
打开android/gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl配置，使其和步骤1的Gradle插件版本对应：
例：Gradle插件7.4.0对应distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
步骤3：清理缓存重新构建
在项目根目录依次执行以下命令：
```
flutter clean
flutter pub get
```
手动删除android目录下的.gradle隐藏文件夹后，重新执行flutter run启动应用。
步骤4：检查App级别Gradle配置
如果上述操作无效，打开android/app/build.gradle文件，确认android配置块开头无拼写错误、没有多余的字符串赋值，确保写法为标准的android {开头，没有将android变量误赋值为字符串的情况。