Flutter Windows调试报错：Scaffold.geometryOf()仅可在绘制阶段访问

问题现象 #

• 点击FloatingActionButton（FAB）触发页面返回时，抛出Scaffold.geometryOf() must only be accessed during the paint phase异常
• 异常出现后移动鼠标，会触发大量mouse_tracker断言错误，导致页面所有元素无法点击
• 点击系统返回键或页面内置返回按钮无此问题

初始异常堆栈 #

ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: Scaffold.geometryOf() must only be accessed during the paint phase.
The ScaffoldGeometry is only available during the paint phase, because its value is computed during the animation and layout phases prior to painting.
#0      _ScaffoldGeometryNotifier.value.<anonymous closure> (package:flutter/src/material/scaffold.dart:835:9)
#1      _ScaffoldGeometryNotifier.value (package:flutter/src/material/scaffold.dart:842:6)
#2      _BottomAppBarClipper.getClip (package:flutter/src/material/bottom_app_bar.dart:238:35)

后续mouse_tracker错误 #

[ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: 'package:flutter/src/rendering/mouse_tracker.dart': Failed assertion: line 195 pos 12: '!_debugDuringDeviceUpdate': is not true.
#0      _AssertionError._doThrowNew (dart:core-patch/errors_patch.dart:51:61)
#1      _AssertionError._throwNew (dart:core-patch/errors_patch.dart:40:5)
#2      MouseTracker._deviceUpdatePhase (package:flutter/src/rendering/mouse_tracker.dart:195:12)

FAB点击事件代码 #

void onOkPressed() {
  Navigator.of(context).pop();
}

解决方案 #

1. 延迟执行页面返回 #

在FAB的点击事件中，通过addPostFrameCallback延迟执行pop()，确保当前渲染周期完成后再触发页面跳转，避免打断Scaffold的渲染流程：

void onOkPressed() {
  WidgetsBinding.instance.addPostFrameCallback((_) {
    Navigator.of(context).pop();
  });
}

2. 规范BottomAppBar的使用逻辑 #

如果自定义了BottomAppBar的clipper或依赖ScaffoldGeometry的计算逻辑，需确保相关操作仅在paint阶段执行：

• 禁止在build方法、布局阶段直接调用Scaffold.geometryOf()
• 若需基于ScaffoldGeometry调整UI，使用LayoutBuilder监听布局变化，或通过ScaffoldGeometryNotifier的回调获取正确时机

3. 升级Flutter版本 #

该异常属于框架渲染周期冲突的已知问题，升级到最新稳定版Flutter大概率能解决此bug：

flutter upgrade

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