Flutter项目Gradle报错：未找到'dev.flutter.flutter-gradle-plugin'插件

错误详情 #

构建应用时触发如下Gradle错误：

Could not apply requested plugin [id: 'dev.flutter.flutter-gradle-plugin', version: '1.0.0'] as 
it does not provide a plugin with id 'dev.flutter.flutter-gradle-plugin'. This is caused by an 
incorrect plugin implementation. Please contact the plugin author(s).
> Plugin with id 'dev.flutter.flutter-gradle-plugin' not found.

错误出自应用模块build.gradle中的这一行：

apply plugin: 'dev.flutter.flutter-gradle-plugin'

解决步骤 #

• 验证Flutter环境
  执行flutter doctor命令，检查并修复所有环境依赖问题，确保Flutter SDK路径配置正确，Gradle相关组件完整。

• 修正插件引用逻辑
  Flutter的Gradle插件无需手动指定版本，且正确的引入方式依赖SDK内置脚本：

  1. 删除应用模块build.gradle中手动指定版本的插件引用行
  2. 确认项目根目录build.gradle的仓库配置包含google()和mavenCentral()，无需手动添加flutter-gradle-plugin的classpath
  3. 在应用模块build.gradle中替换为Flutter官方脚本引用：

     apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
     

• 清理缓存并重新同步

  1. 删除项目根目录下的.gradle和build文件夹
  2. 运行flutter clean清理Flutter构建缓存
  3. 在IDE中执行"Sync Project with Gradle Files"操作

• 匹配Flutter与Gradle版本
  确保使用的Flutter版本与Gradle版本兼容，可通过flutter upgrade升级至稳定版，或参考官方文档确认对应版本的Gradle要求。

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