flutter中 onGenerateRoute回调函数

在 Flutter 中，onGenerateRoute是一个用于‌动态生成路由‌的回调函数，通常在MaterialApp或CupertinoApp中配置。它会在以下两种情况下被调用：

• 使用Navigator.pushNamed(context, routeName, arguments: ...)跳转时，‌路由名称未在routes字典中注册‌；
• 需要根据路由名称和参数‌动态决定返回哪个页面‌（例如权限校验、按需加载等）。

作用

• ‌处理未注册的命名路由‌：作为“兜底”机制，避免因跳转不存在的路由而崩溃。
• ‌统一路由逻辑‌：可在一处集中处理路由参数、权限、埋点等逻辑。
• ‌支持深度链接（Deep Link）‌：尤其在 Web 或 App Link 场景下，可动态解析 URL 并映射到对应页面。

代码示例

MaterialApp( onGenerateRoute: (RouteSettings settings) { // 根据路由名称动态返回页面 switch (settings.name) { case '/': return MaterialPageRoute(builder: (_) => HomePage()); case '/detail': final args = settings.arguments as Map<String, dynamic>; return MaterialPageRoute( builder: (_) => DetailPage(id: args['id'], title: args['title']), ); default: return MaterialPageRoute(builder: (_) => NotFoundPage()); // 404 页面 } }, initialRoute: '/', );

跳转时使用命名路由：

Navigator.pushNamed(context, '/detail', arguments: {'id': '123', 'title': '详情'});

与routes和onUnknownRoute的关系

• routes：预定义路由表，适用于静态、已知页面。
• onGenerateRoute：动态生成路由，优先级高于routes（若同时定义，onGenerateRoute会接管所有命名路由跳转）。
• onUnknownRoute：仅在onGenerateRoute也未处理该路由时调用（Flutter 官方文档建议‌不要同时使用onGenerateRoute和onUnknownRoute‌，以免逻辑冲突）‌。

注意：若定义了onGenerateRoute，则 ‌routes将被忽略‌，所有命名路由跳转都会走onGenerateRoute回调 ‌。

应用场景

• ‌权限控制‌：未登录时跳转到登录页。
• ‌参数校验‌：对传入的arguments进行类型检查或默认值填充。
• ‌模块化路由管理‌：将路由逻辑抽离到独立文件（如router.dart），提升代码可维护性 ‌。
• ‌Web 深度链接‌：使 URL 地址栏与页面路由同步 ‌。

建议

• ‌优先使用onGenerateRoute替代routes‌，尤其在中大型项目中，便于统一管理
• ‌避免同时设置onUnknownRoute‌，防止逻辑重复或冲突 ‌
• ‌在onGenerateRoute中始终返回有效的PageRoute‌，否则应用可能崩溃
• 可结合ModalRoute.of(context)?.settings.arguments在目标页面接收参数 ‌