MacOS运行Flutter应用触发flutter.gradle第1156行错误求助

问题描述 #

在MacOS上运行Flutter应用时出现如下错误：

脚本 '/Users/macbookair/flutter/packages/flutter_tools/gradle/flutter.gradle' 行：1156

已尝试的解决步骤 #

• 执行 flutter run 触发错误
• 执行过 flutter clean
• 执行过 flutter pub get
• 执行过 flutter pub upgrade
• 删除过 .build、build、.idea、pubspec.lock、.dart_tools 等文件
• 从仓库重新克隆应用

预期结果 #

应用正常启动运行

实际错误输出 #

FAILURE: Build failed with an exception.

* Where:
Script '/Users/macbookair/flutter/packages/flutter_tools/gradle/flutter.gradle' line: 1156

* What went wrong:
Execution failed for task ':app:compileFlutterBuildDebug'.
> Process 'command '/Users/macbookair/flutter/bin/flutter'' finished with non-zero exit value 1

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 3s
Exception: Gradle task assembleDebug failed with exit code 1

flutter doctor -v 结果 #

[✓] Flutter (Channel stable, 3.0.5, on macOS 12.4 21F79 darwin-arm, locale en)
    • Flutter version 3.0.5 at /Users/macbookair/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision f1875d570e (4 days ago), 2022-07-13 11:24:16 -0700
    • Engine revision e85ea0e79c
    • Dart version 2.17.6
    • DevTools version 2.12.2

[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
    • Android SDK at /Users/macbookair/Library/Android/sdk
    • Platform android-33, build-tools 33.0.0
    • Java binary at: /Applications/Android
      Studio.app/Contents/jre/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build
      11.0.12+0-b1504.28-7817840)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 13.4.1)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • CocoaPods version 1.11.3

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2021.2)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build
      11.0.12+0-b1504.28-7817840)

[✓] VS Code (version 1.69.1)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.44.0

[✓] Connected device (3 available)
    • sdk gphone64 arm64 (mobile) • emulator-5554 • android-arm64  • Android 12
      (API 32) (emulator)
    • macOS (desktop)             • macos         • darwin-arm64   • macOS 12.4
      21F79 darwin-arm
    • Chrome (web)                • chrome        • web-javascript • Google
      Chrome 103.0.5060.114

[✓] HTTP Host Availability
    • All required HTTP hosts are available

• No issues found!

解决方案 #

1. 获取详细错误日志 #

当前错误仅提示进程退出码1，缺乏具体原因。运行以下命令获取完整错误信息：

flutter run --verbose

或

flutter run --stacktrace

通过详细日志定位具体问题（如代码错误、依赖冲突、资源缺失等）。

2. 检查并修复代码问题 #

执行代码分析命令，排查项目中的语法错误或潜在问题：

flutter analyze

修复分析结果中列出的所有错误和警告后，重新尝试运行应用。

3. 清理Gradle缓存 #

Gradle缓存损坏可能导致构建失败，删除本地Gradle缓存目录：

rm -rf ~/.gradle/caches

之后重新运行flutter run，让Gradle重新下载依赖并生成缓存。

4. 排查依赖冲突 #

检查pubspec.yaml中的第三方依赖，尝试暂时注释部分依赖，逐个运行应用，确定是否由特定依赖导致问题。若找到冲突依赖，更新其版本或寻找替代方案。

5. 验证Gradle与Flutter版本兼容性 #

打开项目中android/build.gradle文件，检查Gradle插件版本（如classpath 'com.android.tools.build:gradle:x.x.x'），确保其与Flutter 3.0.5版本兼容。若版本不匹配，升级或降级Gradle插件至对应兼容版本。

6. 检查iOS配置（若运行iOS设备/模拟器） #

进入项目ios目录，执行以下命令更新CocoaPods依赖：

pod install

同时检查Xcode中的签名配置、开发者账号是否正常，确保iOS构建环境配置正确。

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