如何解决flutter.gradle第1201行错误导致的App设备运行失败问题？

错误详情 #

• 错误位置：C:\Users\lin37\flutter\packages\flutter_tools\gradle\flutter.gradle 第1201行
• 失败任务：:app:compileFlutterBuildRelease
• 核心错误：执行C:\Users\lin37\flutter\bin\flutter.bat进程返回非零退出值1
• 构建结果：assembleRelease任务失败，退出码1，总耗时21秒

错误行对应代码片段 #

project.exec {
    logging.captureStandardError LogLevel.ERROR
    executable flutterExecutable.absolutePath
    workingDir sourceDir
    if (localEngine != null) {
        args "--local-engine", localEngine
        args "--local-engine-src-path", localEngineSrcPath
    }
    if (verbose) {
        args "--verbose"
    } else {
        args "--quiet"
    }
    args "assemble"
    args "--no-version-check"
    args "--depfile", "${intermediateDir}/flutter_build.d"
    args "--output", "${intermediateDir}"
    if (performanceMeasurementFile != null) {
        args "--performance-measurement-file=${performanceMeasurementFile}"
    }
    if (!fastStart || buildMode != "debug") {
        args "-dTargetFile=${targetPath}"
    } else {
        args "-dTargetFile=${Paths.get(flutterRoot.absolutePath, "examples", "splash", "lib", "main.dart")}"
    }
    args "-dTargetPlatform=android"
    args "-dBuildMode=${buildMode}"
    if (trackWidgetCreation != null) {
        args "-dTrackWidgetCreation=${trackWidgetCreation}"
    }
    if (splitDebugInfo != null) {
        args "-dSplitDebugInfo=${splitDebugInfo}"
    }
    if (treeShakeIcons == true) {
        args "-dTreeShakeIcons=true"
    }
    if (dartObfuscation == true) {
        args "-dDartObfuscation=true"
    }
    if (dartDefines != null) {
        args "--DartDefines=${dartDefines}"
    }
    if (bundleSkSLPath != null) {
        args "-dBundleSkSLPath=${bundleSkSLPath}"
    }
    if (codeSizeDirectory != null) {
        args "-dCodeSizeDirectory=${codeSizeDirectory}"
    }
    if (extraGenSnapshotOptions != null) {
        args "--ExtraGenSnapshotOptions=${extraGenSnapshotOptions}"
    }
    if (extraFrontEndOptions != null) {
        args "--ExtraFrontEndOptions=${extraFrontEndOptions}"
    }
    args ruleNames
}
}
}

排查与解决步骤 #

1. 先获取详细错误日志 #

现有错误仅提示进程退出，无具体原因，执行以下命令获取完整日志：

• 带堆栈跟踪的构建命令：

  flutter build apk --release --stacktrace
  

• 或更详细的调试日志：

  flutter build apk --release --debug
  

2. 常见问题排查方向 #

针对该错误位置（Gradle调用Flutter assemble命令失败），重点排查以下场景：

• Dart代码问题：检查项目中是否有语法错误、未定义的变量/方法，Release模式的严格类型检查会暴露Debug模式忽略的问题。
• 资源配置错误：
  • 核对pubspec.yaml中资源路径是否正确，尤其是图标、字体等文件。
  • 若开启treeShakeIcons，确认所有使用的图标都被正确引用，无缺失或路径错误。
• 构建配置问题：
  • 检查android/app/build.gradle的Release配置，比如混淆规则、splitDebugInfo路径是否合法。
  • 确认dartDefines中的参数格式正确，无语法错误。
• Flutter环境问题：
  • 执行flutter doctor检查依赖完整性，修复所有提示的问题（如Android SDK版本、许可证等）。
  • 切换到稳定版Flutter：

    flutter channel stable
    flutter upgrade
    

• 缓存冲突问题：
  • 清理Flutter缓存：

    flutter clean
    

  • 删除android/.gradle和本地Gradle缓存目录（如C:\Users\lin37\.gradle\caches）后重新构建。

3. 针对性修复 #

根据详细日志提示的具体错误，直接定位修复：

• 若提示TargetFile路径错误，检查项目main.dart路径是否正确，或构建配置中是否指定了错误的入口文件。
• 若提示资源找不到，核对pubspec.yaml资源声明和实际文件路径是否一致。
• 若提示混淆错误，调整proguard-rules.pro中的规则，确保Flutter相关代码不被误混淆。

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