基于Flutter Bloc自定义路由遇异常：原因及解决方法

第一个异常：断言错误 !pageBased || route.settings is Page #

原因 #

当Navigator启用pageBased模式（通常通过pages属性配置或使用Page-based导航API）时，Flutter强制要求所有路由的settings必须是Page子类的实例。你的代码大概率存在以下问题：

• 跳转路由时使用了普通RouteSettings而非自定义的MyPage实例；
• onGenerateRoute回调中返回的路由对象，其settings未关联正确的Page实例；
• Navigator的pages列表中混入了非Page类型的设置项。

修复方案 #

1. 所有路由跳转统一使用Page实例：

   // 替换错误的传统路由跳转
   Navigator.of(context).push(
     MaterialPageRoute(builder: (_) => ...),
   );
   // 改为基于Page的跳转方式
   Navigator.of(context).push(MyPage(name: 'detail'));
   

2. 如果使用onGenerateRoute，确保返回的路由关联对应的Page设置：

   Route? onGenerateRoute(RouteSettings settings) {
     if (settings is MyPage) {
       return MaterialPageRoute(
         settings: settings, // 必须传递Page类型的settings
         builder: (_) => settings.buildPage(context, null, null),
       );
     }
     return null;
   }
   

3. 确认Navigator的pageBased模式配置正确，避免混合使用传统路由和Page-based路由逻辑。

第二个异常：A GlobalKey was used multiple times inside one widget's child list #

原因 #

虽然你声明navigatorKey仅在MyApp中使用一次，但可能存在以下隐藏问题：

• 某个页面/Widget的GlobalKey被声明在build方法内部，导致每次Widget重建时生成新的Key实例，却重复绑定到同类型Widget；
• 多个Widget实例复用了同一个GlobalKey对象（比如动态生成的页面/列表项中意外共享Key）；
• BlocBuilder的builder函数中，状态变化时重新创建了持有相同GlobalKey的Widget。

修复方案 #

1. 将GlobalKey声明为Widget类的成员变量，而非build方法内部：

   class MyDetailPage extends StatelessWidget {
     // 正确：类级别声明GlobalKey，确保实例唯一
     final GlobalKey _formKey = GlobalKey<FormState>();
   
     @override
     Widget build(BuildContext context) {
       return Form(key: _formKey, ...);
     }
   }
   

2. 动态生成页面/列表项时，确保每个Widget使用唯一Key：

   // 错误：所有列表项共享同一个Key
   final GlobalKey _itemKey = GlobalKey();
   ListView.builder(
     itemBuilder: (_, index) => ListTile(key: _itemKey),
   );
   // 正确：每个项使用独立的UniqueKey
   ListView.builder(
     itemBuilder: (_, index) => ListTile(key: UniqueKey()),
   );
   

3. 检查BlocBuilder的builder逻辑，避免状态重建时重复创建持有相同GlobalKey的Widget。

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