Flutter Android Release构建失败求助，Debug正常iOS可构建

报错信息 #

* Where:
 Script '/Users/marendra/flutter/packages/flutter_tools/gradle/flutter.gradle'  line: 1159

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

已尝试无效操作 #

• flutter pub cache clean
• flutter pub get
• iOS版本可通过Xcode成功构建，但命令行构建失败

环境信息（flutter doctor -v） #

[✓] Flutter (Channel stable, 3.3.4, on macOS 12.6 21G115 darwin-arm, locale en-ID)
• Flutter version 3.3.4 on channel stable at /Users/marendra/flutter
• Upstream repository https://github.com/flutter/flutter.git
• Framework revision eb6d86ee27 (13 days ago), 2022-10-04 22:31:45 -0700
• Engine revision c08d7d5efc
• Dart version 2.18.2
• DevTools version 2.15.0

[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
• Android SDK at /Users/marendra/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.13+0-b1751.21-8125866)
• All Android licenses accepted.

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

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

[✓] Android Studio (version 2021.3)
• 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.13+0-b1751.21-8125866)

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

[✓] Connected device (3 available)
• sdk gphone64 arm64 (mobile) • emulator-5554 • android-arm64  • Android 13 (API 33) (emulator)
• macOS (desktop)             • macos         • darwin-arm64   • macOS 12.6 21G115 darwin-arm
• Chrome (web)                • chrome        • web-javascript • Google Chrome 106.0.5249.119

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

排查与解决步骤 #

1. 获取详细构建日志 #

执行带-v参数的构建命令，定位具体失败原因：

flutter build apk --release -v

重点查看non-zero exit value 1之前的报错内容，比如语法错误、资源缺失、依赖冲突等。

2. 检查Android构建配置 #

• 打开android/app/build.gradle，确认compileSdkVersion、targetSdkVersion与本地Android SDK版本（33）匹配。
• 检查minSdkVersion是否符合第三方依赖要求，部分库需要更高的最低版本。
• 确认Release签名配置正确，未配置签名会导致构建失败：

  signingConfigs {
      release {
          keyAlias 'your_key_alias'
          keyPassword 'your_key_password'
          storeFile file('your_keystore_path.jks')
          storePassword 'your_store_password'
      }
  }
  buildTypes {
      release {
          signingConfig signingConfigs.release
          // 其他配置
      }
  }
  

3. 清理Android模块缓存 #

单独清理Android模块后重新构建：

cd android
./gradlew clean
cd ..
flutter build apk --release

4. 检查第三方依赖兼容性 #

• 运行flutter pub outdated查看依赖更新情况，尝试升级到稳定版本。
• 若使用原生Android插件，确认其适配Android 13（API 33），比如权限申请、Manifest配置是否合规。

5. 重置Flutter环境 #

切换到最新稳定版或重新安装Flutter：

flutter channel stable
flutter upgrade
# 若问题依旧，重新安装Flutter
rm -rf /Users/marendra/flutter
git clone https://github.com/flutter/flutter.git

6. 修复文件权限 #

确保Flutter和项目目录有足够读写权限：

chmod -R 755 /Users/marendra/flutter
chmod -R 755 /path/to/your/project

7. iOS命令行构建额外处理 #

既然Xcode能成功构建，尝试：

cd ios
pod deintegrate
pod install
cd ..
flutter build ios --release

同时检查Xcode命令行工具配置：

xcode-select --print-path
# 路径错误时执行
xcode-select --switch /Applications/Xcode.app/Contents/Developer

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