Flutter打开drawer时出现Unexpected null value空值异常该如何解决

根本原因 #

报错是openOrCloseDrawer方法中_scaffoldKey.currentState!的非空断言触发空异常，核心原因是ViewModel中定义的GlobalKey<ScaffoldState>没有绑定到实际渲染的Scaffold组件上，导致无法获取到Scaffold的状态实例。

修复步骤 #

1. 绑定GlobalKey到Scaffold
   找到你项目中承载Header、SideMenu的主页面Scaffold组件，通过状态管理获取到全局唯一的MainViewModel实例，将Scaffold的key属性赋值为viewModel.scaffoldkey，同时将Scaffold的drawer属性赋值为SideMenu()组件，示例如下：

// 主页面的build方法示例
@override
Widget build(BuildContext context) {
  return BaseScreen<MainViewModel>(
    builder: (context, viewModel, _) {
      return Scaffold(
        key: viewModel.scaffoldkey, // 必须加这行绑定key
        drawer: SideMenu(), // 绑定侧边栏组件
        body: Column(
          children: [
            Header(),
            // 其他页面内容
          ],
        ),
      );
    },
  );
}

2. 优化方法避免空崩溃
   修改openOrCloseDrawer方法，增加空判断替代强制非空断言，避免异常：

void openOrCloseDrawer() {
  final scaffoldState = _scaffoldKey.currentState;
  if (scaffoldState == null) return;
  if (scaffoldState.isDrawerOpen) {
    scaffoldState.openEndDrawer();
  } else {
    scaffoldState.openDrawer();
  }
  setState(ViewState.Idle);
}

3. 确保ViewModel实例全局唯一
   如果你的BaseScreen默认每次创建新的ViewModel实例，需要将MainViewModel注册为全局单例，保证Header、主页面Scaffold、SideMenu获取到的是同一个ViewModel实例，避免key不匹配的问题。

内容的提问来源于stack exchange，提问作者Mahmoud Al-Haroon