Flutter报错：未找到ScaffoldMessenger组件，如何修复？

错误含义 #

这个错误的核心是：你调用ScaffoldMessenger.of(context)时，使用的context无法在组件树的祖先节点中找到ScaffoldMessenger。

具体来说，你的TabBarDemo组件的build方法直接返回了MaterialApp，而ScaffoldMessenger是MaterialApp内部创建的组件——也就是说，MaterialApp是当前context的子节点，上下文查找是从当前节点向上遍历祖先，自然找不到下方的ScaffoldMessenger。

修复方案 #

方案一：使用全局Key直接获取ScaffoldMessenger状态 #

给MaterialApp绑定一个GlobalKey，通过key直接调用ScaffoldMessenger的方法，绕过上下文查找的限制：

final GlobalKey<ScaffoldMessengerState> _scaffoldKey = GlobalKey();

@override
Widget build(BuildContext context) {
  return MaterialApp(
    scaffoldMessengerKey: _scaffoldKey,
    home: DefaultTabController(
      length: 3,
      child: Scaffold(
        drawer: SideBar(),
        appBar: AppBar(
          bottom: TabBar(
            onTap: (index) {
              _scaffoldKey.currentState?.showSnackBar(
                SnackBar(content: Text(index.toString()))
              );
            },
            tabs: const [
              Tab(text: "Tab 1"),
              Tab(text: "Tab 2"),
              Tab(text: "Tab 3"),
            ],
          ),
        ),
      ),
    ),
  );
}

方案二：调整组件结构，让上下文能找到ScaffoldMessenger #

把MaterialApp抽离到TabBarDemo的上层，让TabBarDemo成为MaterialApp的子组件——这样TabBarDemo的context就能向上遍历到MaterialApp提供的ScaffoldMessenger：

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: const TabBarDemo(),
    );
  }
}

class TabBarDemo extends StatefulWidget {
  const TabBarDemo({super.key});

  @override
  State<TabBarDemo> createState() => _TabBarDemoState();
}

class _TabBarDemoState extends State<TabBarDemo> {
  @override
  Widget build(BuildContext context) {
    return DefaultTabController(
      length: 3,
      child: Scaffold(
        drawer: SideBar(),
        appBar: AppBar(
          bottom: TabBar(
            onTap: (index) {
              ScaffoldMessenger.of(context).showSnackBar(
                SnackBar(content: Text(index.toString()))
              );
            },
            tabs: const [
              Tab(text: "Tab 1"),
              Tab(text: "Tab 2"),
              Tab(text: "Tab 3"),
            ],
          ),
        ),
      ),
    );
  }
}

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