Flutter中Navigator.pop与pushNamed组合使用报错问题排查

问题根源 #

你遇到的空检查错误，核心原因是关闭对话框后，原对话框的context已失效：
当执行Navigator.pop(context)时，对话框对应的Widget会被从Widget树中移除，这个context关联的Element已经不存在。后续用这个失效的context调用Navigator.pushNamed，内部的空校验就会触发Null check operator used on a null value错误。

可行解决方案 #

方案1：使用根导航器上下文 #

在关闭对话框前，先获取根导航器的有效上下文，后续跳转用这个根上下文：

onPressed: () {
  // 获取根导航器的上下文，不受对话框关闭影响
  final rootNavContext = Navigator.of(context, rootNavigator: true);
  
  Navigator.pop(context); // 关闭对话框
  _authService.loginUser(context).then((_) {
    if (_firebaseAuth.currentUser != null) {
      Future.delayed(const Duration(seconds: 2), () {
        Navigator.pushNamed(rootNavContext, MainPage.id);
      });
    }
  });
}

方案2：调整逻辑顺序（先登录再关对话框） #

先完成登录校验，确认成功后再关闭对话框，此时对话框的context仍有效，后续跳转也不会出问题：

onPressed: () {
  _authService.loginUser(context).then((_) {
    if (_firebaseAuth.currentUser != null) {
      Navigator.pop(context); // 登录成功后再关闭对话框
      Future.delayed(const Duration(seconds: 2), () {
        Navigator.pushNamed(context, MainPage.id);
      });
    } else {
      // 处理登录失败逻辑，比如提示错误
    }
  });
}

方案3：使用全局导航键 #

提前定义全局的导航键，完全脱离上下文限制：

1. 在全局范围定义导航键：

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

2. 在MaterialApp中配置：

MaterialApp(
  navigatorKey: navigatorKey,
  // ...其他配置
)

3. 按钮点击逻辑中使用：

onPressed: () {
  Navigator.pop(context);
  _authService.loginUser(context).then((_) {
    if (_firebaseAuth.currentUser != null) {
      Future.delayed(const Duration(seconds: 2), () {
        navigatorKey.currentState?.pushNamed(MainPage.id);
      });
    }
  });
}

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