Flutter Navigator返回操作触发黑色404页面问题求助

问题根因 #

• 登录成功跳转时错误使用popAndPushNamed方法：该方法执行逻辑为先弹出当前栈顶的登录页，再压入首页路由。由于登录页是应用启动后的初始路由（路由栈内唯一页面），弹出登录页的瞬间路由栈会被清空，Flutter 找不到可渲染的有效路由时就会生成带404标识的黑色空白页。后续虽然压入了首页路由，但异常的路由栈状态没有被重置，触发右滑返回手势时就会回到这个异常页面。
• 首页固定布局中的TopCard点击回调直接调用Navigator.of(context).pop()存在隐患：如果用户在未打开底部弹窗的状态下点击该卡片，会直接尝试弹出首页路由，进一步触发路由栈异常。

修复步骤 #

1. 替换登录页跳转逻辑
   将popAndPushNamed替换为pushReplacementNamed，该方法会直接用首页路由替换栈顶的登录页，不会执行先弹出空栈的操作，跳转完成后路由栈仅保留首页，用户无法返回登录页，完全符合业务预期。
   修改后登录按钮的回调代码：

onPressed: () async {
  final res = await Authentication.signInWithGoogle();
  await Authentication.userSetup(res.user!);
  Navigator.of(context).pushReplacementNamed(HomePage.routeName);
},

2. 修正首页pop逻辑
   TopCard中的pop()如果是为了关闭底部添加弹窗，需要将该组件移动到showModalBottomSheet的布局内部，使用弹窗自身的context执行关闭操作；如果TopCard是首页固定展示的模块，直接删除回调中的Navigator.of(context).pop()代码，避免误弹出路由。

3. 可选加固：拦截首页非法返回
   如果需要彻底禁止首页触发系统返回（包括iOS右滑返回、安卓实体返回键），可以给首页的Scaffold外层包裹WillPopScope拦截返回事件，参考代码：

@override
Widget build(BuildContext context) {
  return ChangeNotifierProvider(
    create: (_) => ItemsProvider(),
    child: Consumer<ItemsProvider>(
      builder: (_, provider, __) => WillPopScope(
        onWillPop: () async => false,
        child: Scaffold(
          // 原有Scaffold内容保持不变
          resizeToAvoidBottomInset: false,
          appBar: AppBar(
            automaticallyImplyLeading: false,
            actions: [
              IconButton(
                  onPressed: () => Navigator.of(context).pushNamed('/user'),
                  icon: const Icon(Icons.person)),
            ],
          ),
          floatingActionButton: Visibility(
            visible: provider.buttonVisibility,
            child: FloatingActionButton(
                heroTag: "btn1",
                backgroundColor: AppColors.red,
                child: const Icon(Icons.add, color: AppColors.splashColor),
                onPressed: () {
                  showModalBottomSheet(
                    context: context,
                    isScrollControlled: true,
                    builder: (context) => buildModal(context, provider),
                  );
                }),
          ),
          // 剩余原有页面代码...
        ),
      ),
    ),
  );
}

内容的提问来源于stack exchange，提问作者Giorgia Di Placido