Flutter中build方法直接调用ScaffoldMessenger.showSnackBar失效原因

直接在build方法中调用showSnackBar报错的核心原因有三个：

• context查找时机不合法
  build方法执行阶段，当前widget还处于构建过程中，并未完全挂载到Widget树中。此时调用ScaffoldMessenger.of(context)尝试通过当前context查找上层的ScaffoldMessenger实例时，要么还找不到已初始化的实例，要么context还未完成和Widget树的绑定，直接就会抛出instance not found类型的异常。
• 违背build方法的设计原则
  Flutter要求build方法是无副作用的纯函数，仅负责返回需要渲染的Widget结构。调用showSnackBar属于会修改页面状态的副作用操作，本身就不允许在build流程中执行。
• 存在逻辑异常风险
  build方法会被频繁触发：父widget重绘、当前widget状态更新、屏幕配置变化（比如旋转、分辨率调整）都会触发build重执行。如果把showSnackBar写在build里，会导致每次build都弹出新的SnackBar，最终出现无限弹窗的异常逻辑。

你用GlobalKey<ScaffoldState>能生效的原因 #

GlobalKey是全局唯一的键，会直接持有对应Scaffold的状态实例，不需要通过当前context在Widget树中向上查找实例，所以绕过了build阶段context无效的问题。但如果没有控制调用时机，还是会出现每次build都弹SnackBar的逻辑问题。

正确的页面初始化弹SnackBar的实现方式 #

如果需求是页面加载完成后自动弹出SnackBar，不要直接在build里调用，应该在initState中绑定帧绘制结束回调，等第一帧绘制完成、widget完全挂载后再执行操作：

@override
void initState() {
  super.initState();
  // 监听第一帧绘制完成回调
  WidgetsBinding.instance.addPostFrameCallback((_) {
    _showToast(context);
  });
}

void _showToast(BuildContext context) {
  final scaffold = ScaffoldMessenger.of(context);
  scaffold.showSnackBar(
    SnackBar(content: const Text('Added to favorite')),
  );
}

这个方案不需要额外定义GlobalKey，也不会出现调用时机异常的问题。

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