Flutter Android与Web端main()函数重复执行问题求助

问题详情 #

在Android和Flutter Web平台上，应用入口main()函数会被触发两次，导致启动阶段的所有流程（尤其是会话恢复相关的API请求）重复执行。

测试代码示例：

var x = 0;
void main() {
  print(++x);
}

日志会两次输出1。即使简化main()仅打印堆栈信息：

void main() {
  print(StackTrace.current);
}

仍会重复输出相同的堆栈内容。

已尝试的排查动作 #

• 全局搜索项目中对main()的显式调用
• 重置Android目录至初始状态
• 执行flutter clean、flutter pub get命令
• 删除build文件夹

查阅相关问题后，多数结果聚焦FutureBuilder或build()方法，仅找到一个未解决的同类问题，项目无特殊配置。

排查与解决建议 #

1. 升级Flutter SDK
   部分旧版本Flutter在Web平台存在main()重复触发的已知bug，直接升级到最新稳定版：

   flutter upgrade
   

2. 检查AndroidManifest配置
   打开android/app/src/main/AndroidManifest.xml，确认：

   • 仅存在一个带有<intent-filter>的启动Activity
   • Activity的launchMode未设置为可能导致重复启动的模式（比如standard在某些场景下会重复创建实例，可暂时改为singleTop测试）
   • 无第三方插件在Manifest中注册了额外的启动逻辑

3. 检查Web平台index.html
   查看web/index.html，确保只引入了一次Flutter初始化脚本：

   <script src="main.dart.js" type="application/javascript"></script>
   

   同时检查是否有其他自定义脚本意外触发了Flutter的重新初始化。

4. 排查第三方插件
   逐一禁用项目中的第三方依赖，每次禁用后重新运行测试，定位是否有插件内部触发了main()的二次调用。重点排查涉及启动监听、生命周期管理的插件。

5. 临时规避方案
   如果暂时无法定位根源，可以通过单例标记确保核心初始化逻辑只执行一次：

   bool _isInitialized = false;
   
   void main() {
     if (!_isInitialized) {
       _isInitialized = true;
       // 这里放置你的初始化逻辑（API请求、会话恢复等）
       print("初始化流程仅执行一次");
     }
   }
   

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