Flutter 如何在主页面中清除Navigator所有历史路由禁止返回上一页

可以在主页面直接实现该需求，常用有两种落地方式，可根据你的项目需求选择：

直接在主页面外层包裹返回拦截组件，不管路由栈中是否存在历史页面，都禁止用户通过返回按钮、侧滑手势返回，完全不依赖跳转时的路由处理逻辑，从根源避免开发者忘记清栈的问题。

注意：Flutter 3.16版本开始官方废弃了WillPopScope，推荐使用新的PopScope组件。

代码示例：

// Flutter 3.16及以上版本实现
class HomePage extends StatefulWidget {
  const HomePage({super.key});

  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  @override
  Widget build(BuildContext context) {
    return PopScope(
      canPop: false, // 直接禁止所有返回行为
      child: Scaffold(
        appBar: AppBar(title: const Text("主页面")),
        // 你的主页面业务代码
      ),
    );
  }
}

// 低于3.16版本的Flutter实现
@override
Widget build(BuildContext context) {
  return WillPopScope(
    onWillPop: () async => false, // 返回false拦截返回操作
    child: Scaffold(
      // 主页面业务代码
    ),
  );
}

该方案会自动隐藏AppBar的默认返回按钮，同时拦截系统返回键、侧滑返回手势，满足禁用返回需求。

如果你需要同时清理历史页面释放内存，可以在主页面初始化时主动清空路由栈中除当前主页面外的所有路由。

代码示例：

class _HomePageState extends State<HomePage> {
  @override
  void initState() {
    super.initState();
    // 加帧回调避免页面渲染过程中操作路由触发异常
    WidgetsBinding.instance.addPostFrameCallback((_) {
      // 方式1：仅保留当前栈底路由（适合主页面是初始路由的场景）
      Navigator.of(context).removeUntil((route) => route.isFirst);

      // 方式2：按路由名匹配保留主页面（适合用命名路由的项目，更稳定）
      // Navigator.of(context).removeUntil((route) => route.settings.name == '/home');
    });
  }

  @override
  Widget build(BuildContext context) {
    // 可以配合方案1的PopScope一起使用，双重保证
    return PopScope(
      canPop: false,
      child: Scaffold(
        // 主页面业务代码
      ),
    );
  }
}

两种方案可单独使用，也可以结合使用，都不需要依赖跳转主页面时的路由清栈逻辑，完全在主页面内部闭环实现需求。

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