Flutter无法运行任何项目：Target kernel_snapshot failed异常求助

问题描述 #

连续4天尝试解决该问题，搜索相关资源后仍无法解决：运行任意Flutter项目均触发Target kernel_snapshot failed: Exception错误，具体报错信息如下：

FAILURE: Build failed with an exception.

• 位置：脚本'C:\src\flutter\flutter\packages\flutter_tools\gradle\flutter.gradle'第1201行
• 错误原因：任务':app:compileFlutterBuildDebug'执行失败。

进程'command 'C:\src\flutter\flutter\bin\flutter.bat''以非零退出值1结束

已尝试以下常规方案但无效：

• 删除.lock文件
• flutter clean
• flutter pub upgrade
• flutter upgrade
• flutter run --no-sound-null-safety

flutter doctor输出全正常：

[√] Flutter (Channel stable, 3.10.4, on Microsoft Windows [Version 10.0.19045.2965], locale en-US)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[√] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[√] Chrome - develop for the web
[√] Visual Studio - develop for Windows (Visual Studio Community 2022 17.6.2)
[√] Android Studio (version 2022.2)
[√] VS Code (version 1.78.2)
[√] Connected device (4 available)
[√] Network resources

注：仅使用Android Studio开发，未使用Visual Studio。

针对性解决方案 #

1. 修复Flutter依赖缓存 #

• 执行命令修复pub缓存的损坏依赖：

  flutter pub cache repair
  

• 删除Flutter SDK目录下的.cache文件夹（路径：C:\src\flutter\flutter\.cache），之后重新运行flutter doctor完成环境校验。

2. 排查Android Studio与Gradle配置 #

• 打开Android Studio，进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle，勾选"Use Gradle from: wrapper.properties file"，确保使用项目自带的Gradle wrapper，避免版本不兼容。
• 清理Android Studio缓存：File > Invalidate Caches...，勾选"Clear file system cache and local history"，点击"Invalidate and Restart"重启IDE。
• 检查项目android/build.gradle文件，确保Gradle插件与Flutter版本匹配：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2' // 适配SDK 34与Flutter 3.10.x
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.22"
  }
  

3. 系统权限与环境排查 #

• 以管理员身份运行Android Studio和命令提示符，避免权限不足导致的文件写入失败。
• 检查C:\src\flutter\flutter目录的权限，确保当前用户拥有读写权限（右键目录 > 属性 > 安全 > 编辑 > 勾选"完全控制"）。
• 临时关闭杀毒软件或防火墙，防止其拦截Flutter编译进程的文件操作。

4. 验证Flutter环境完整性 #

• 创建全新测试项目，执行以下命令：

  flutter create test_project
  cd test_project
  flutter run
  

  如果全新项目仍报错，说明Flutter SDK本身可能损坏，建议下载官方稳定版压缩包（避免git克隆），解压后替换现有C:\src\flutter\flutter目录，重新配置环境变量。

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