基于用户登录状态导航至首页/初始页时Navigator上下文错误排查

错误原因 #

你遇到的错误：

Navigator operation requested with a context that does not include a Navigator.
The context used to push or pop routes from the Navigator must be that of a widget that is a descendant of a Navigator widget.

核心问题是你代码中用于导航的context不属于Navigator的子树。看你提供的_showAffirmationsAndNavigate方法，在addPostFrameCallback里创建的Builder从未被挂载到Widget树中，它的context是孤立的，自然找不到App中的Navigator实例。

代码问题点 #

• Builder仅被创建但未添加到Widget树，无法关联到App的Navigator上下文
• 试图用一个未挂载的Widget的context做导航，必然触发错误

修正方案 #

方案一：直接使用当前Widget的有效Context #

如果调用_showAffirmationsAndNavigate的Widget是MaterialApp（或Navigator）的后代，直接传入该Widget的context即可：

void _showAffirmationsAndNavigate(BuildContext context) {
  print('Starting _showAffirmationsAndNavigate...');

  if (currentUser == null) {
    print('Error: currentUser is null during navigation.');
  } else {
    print('User is logged in with UID: ${currentUser!.uid}');
  }

  WidgetsBinding.instance.addPostFrameCallback((_) {
    if (currentUser != null) {
      print('Navigating to HomeView...');
      Navigator.of(context).pushReplacement(
        MaterialPageRoute(
          builder: (context) => HomeView(
            userId: currentUser!.uid,
            affirmationService: affirmationService,
          ),
        ),
      );
    } else {
      print('Navigating to InitialScreen for non-logged-in users...');
      Navigator.of(context).pushReplacement(
        MaterialPageRoute(
          builder: (context) => const InitialScreen(),
        ),
      );
    }
  });
}

调用示例（比如在initState或页面事件中）：

@override
void initState() {
  super.initState();
  _showAffirmationsAndNavigate(context);
}

方案二：使用GlobalKey获取NavigatorState #

如果当前场景无法获取到Navigator子树的context（比如在MaterialApp初始化前的逻辑），可以通过全局Key绑定Navigator：

1. 在App根节点定义全局Key：

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

2. 绑定到MaterialApp：

MaterialApp(
  navigatorKey: navigatorKey,
  home: SplashScreen(), // 你的加载页/启动页
  // 其他配置项
)

3. 修改导航逻辑：

void _showAffirmationsAndNavigate() {
  print('Starting _showAffirmationsAndNavigate...');

  if (currentUser == null) {
    print('Error: currentUser is null during navigation.');
  } else {
    print('User is logged in with UID: ${currentUser!.uid}');
  }

  WidgetsBinding.instance.addPostFrameCallback((_) {
    final navigator = navigatorKey.currentState;
    if (navigator == null) {
      print('Navigator state not available');
      return;
    }
    
    if (currentUser != null) {
      print('Navigating to HomeView...');
      navigator.pushReplacement(
        MaterialPageRoute(
          builder: (context) => HomeView(
            userId: currentUser!.uid,
            affirmationService: affirmationService,
          ),
        ),
      );
    } else {
      print('Navigating to InitialScreen for non-logged-in users...');
      navigator.pushReplacement(
        MaterialPageRoute(
          builder: (context) => const InitialScreen(),
        ),
      );
    }
  });
}

适配你的业务逻辑 #

不管用哪种方案，都要确保在加载页、启动页完成后再触发导航逻辑。如果启动页是一个StatefulWidget，可以在其initState中调用接口获取每日宣言，完成后调用上述导航方法。

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