Flutter 2.0中pushAndRemoveUntil调用失效无法清空路由栈问题

问题原因 #

你当前使用的是Flutter 2.0引入的声明式路由（Navigator 2.0/Router API），该模式下路由栈完全由Navigator.pages参数控制，不再支持旧的命令式路由API（比如pushAndRemoveUntil、pop、push等直接操作Navigator实例的方法），因此触发了断言异常。

解决方案 #

方案1：换回命令式路由模式（适合小型项目、不需要声明式路由特性的场景） #

删除MaterialApp/CupertinoApp中配置的routerDelegate和routeInformationParser参数，改用home或onGenerateRoute参数配置路由，原有pushAndRemoveUntil代码即可正常运行。

方案2：通过声明式路由逻辑实现清空栈跳转（适合已深度使用Navigator 2.0的场景） #

直接修改控制Navigator.pages列表的状态逻辑，将pages列表重置为仅包含目标页面对应的Page实例即可，参考实现：

// 以自定义RouterDelegate为例
class MyRouterDelegate extends RouterDelegate<MyRoutePath>
    with ChangeNotifier, PopNavigatorRouterDelegateMixin<MyRoutePath> {
  List<Page> _pages = [];
  List<Page> get pages => _pages;

  // 封装清空栈跳转到登录页的方法
  void clearStackToSignIn() {
    _pages = [
      MaterialPage(
        key: const ValueKey('signIn'),
        child: const SignInPage()
      ),
    ];
    notifyListeners();
  }
}

需要跳转时，调用RouterDelegate实例的clearStackToSignIn()方法即可。

临时兼容方案（不推荐长期使用） #

如果需要快速兼容旧API，调用时指定rootNavigator: true直接操作根路由栈即可：

Navigator.of(context, rootNavigator: true).pushAndRemoveUntil(
  MaterialPageRoute(builder: (context) => const SignInPage()), 
  (route) => false
);

注意：该方案仅在声明式路由嵌套在根路由下的场景生效，会绕过自定义的声明式路由逻辑，仅适合临时过渡使用。

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