Flutter短信上报项目打包APK失败，遇Gradle及main.dart错误求助

问题场景 #

开发Flutter短信上报系统时，执行flutter build apk或flutter build apk --release命令打包APK失败，核心报错为找不到/main.dart文件、未发现main方法，最终Gradle任务assembleRelease执行失败，退出码1。具体报错信息：

Microsoft Windows [Version 10.0.22631.4249]

(c) Microsoft Corporation. All rights reserved.

F:\CurrentSMSAPP\electionresults_results_sms_collation_mobileapp>flutter build apk

 Building with sound null safety 

/main.dart: Error: Error when reading '/main.dart': The system cannot find the file specified.

package:electionresults_results_sms_collation_mobileapp//main.dart: Error: No 'main' method found.

Try adding a method named 'main' to your program.

Target kernel_snapshot failed: Exception

FAILURE: Build failed with an exception.

* Where:

Script 'D:\installed\flutter\packages\flutter_tools\gradle\flutter.gradle' line: 1151

* What went wrong:

Execution failed for task ':app:compileFlutterBuildRelease'.
\> Process 'command 'D:\installed\flutter\bin\flutter.bat'' 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 36s

Running Gradle task 'assembleRelease'...                           38.5s

Gradle task assembleRelease failed with exit code 1

F:\CurrentSMSAPP\electionresults_results_sms_collation_mobileapp>

解决方案 #

• 检查main.dart文件路径
  报错提示找不到根目录下的/main.dart，Flutter默认入口文件路径为项目根目录下的lib/main.dart。确认你的main.dart是否在lib文件夹内，若位置错误，将文件移动到lib目录下。

• 确认main方法存在且正确
  打开lib/main.dart，确保包含标准的Flutter入口方法：

  void main() {
    runApp(const MyApp());
  }
  

  若缺失则添加，若已存在检查是否有拼写错误（如大小写、方法名写错）。

• 验证pubspec.yaml配置
  检查项目根目录的pubspec.yaml，确保name字段与项目包名一致，且没有自定义的入口路径配置（默认无需额外配置，Flutter会自动识别lib/main.dart）。

• 清理缓存后重新构建
  执行以下命令清理项目缓存并重新打包：

  flutter clean
  flutter pub get
  flutter build apk --release
  

• 排查Gradle配置（可选）
  若以上步骤无效，检查android/app/build.gradle中的Flutter配置：
  确认flutter.root路径正确指向你的Flutter安装目录（如D:\installed\flutter），同时检查flutter.versionName、flutter.versionCode等配置是否正常。

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