Flutter多地图页面触发_startMicrotaskLoop异常，求排查解决方法

问题详情 #

开发的Flutter应用包含多个集成Google Maps的页面，运行过程中会在Flutter框架内置的_startMicrotaskLoop函数中抛出异常，相关框架代码片段如下：

_isInCallbackLoop = true;
try {
  // Moved to separate function because try-finally prevents
  // good optimization.
  _microtaskLoop();
} finally {
  _lastPriorityCallback = null;
  _isInCallbackLoop = false;
  if (_nextCallback != null) {
    _AsyncRun._scheduleImmediate(_startMicrotaskLoop);
  }
}

目前错误信息及应用行为中未发现明确的触发诱因。

可行的排查与解决方法 #

• 严格管理Map控制器生命周期：多个页面的Google Maps控制器若未正确释放，会引发资源泄漏并干扰微任务队列。务必在页面的dispose()方法中调用mapController.dispose()，禁止跨页面复用未释放的控制器实例。
• 优化微任务执行时机：Google Maps插件内部可能频繁触发微任务，多页面切换时易造成队列过载。可尝试在页面切换时延迟初始化Map组件，或改用WidgetsBinding.instance.addPostFrameCallback替代initState直接执行Map初始化，分散任务执行压力。
• 升级依赖版本：旧版本Flutter框架或google_maps_flutter插件存在微任务处理的已知bug，升级至稳定版（如Flutter 3.10+、google_maps_flutter 2.5+）可修复此类底层问题。
• 避免Map回调中阻塞主线程：在onCameraMove、onMarkerTap等Map回调内，不要执行大量同步任务或嵌套触发微任务，将耗时操作移至Isolate或通过Future.delayed延迟执行。
• 用DevTools定位问题：借助Flutter DevTools的“Performance”面板监控微任务队列的执行状态，排查异常任务堆积；通过“Memory”面板检查Map相关资源是否存在泄漏。

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