go_router深度链接重定向仅生效一次的问题排查与解决

问题根源 #

GoRouter会缓存路由对应的组件实例，尤其是当你的builder返回const修饰的组件（比如const MyApp()）时，Flutter会复用这个不可变的组件实例，导致builder里的业务代码只会执行一次。另外，你把全局状态更新、GlobalKey创建这类逻辑放在builder中的做法本身就不符合组件构建的设计原则——builder应该只负责UI构建，而非业务逻辑处理。

修复步骤 #

1. 移除const修饰，避免组件缓存
   把路由builder中返回的const MyApp()改成MyApp()，取消const修饰，确保每次路由跳转时都会触发组件的重建（或让MyApp作为StatefulWidget，监听状态变化）。

2. 将业务逻辑从builder中剥离
   不要在GoRoute的builder里处理全局变量赋值、GlobalKey初始化这类操作：

   • GlobalKey应该全局只初始化一次，避免每次路由跳转都创建新的Key导致状态混乱；
   • 全局状态（比如extEventId）的更新应该放在Deep Link的监听回调中，或者通过GoRouter的redirect机制处理。

3. 主动监听Deep Link回调
   确保每次收到Deep Link时，主动触发路由跳转并更新全局状态，不依赖GoRouter的自动匹配缓存。

修改后的代码示例 #

1. 调整全局变量初始化

class Globals {
  static int? extEventId;
  // 全局只初始化一次NavigatorKey，避免重复创建
  static final navigatorKey = GlobalKey<NavigatorState>();
}

2. 初始化Deep Link监听

void main() {
  _initDeepLinkListener();
  
  runApp(
    GlobalLoaderOverlay(
      overlayWidgetBuilder: (progress) => Theme(
        data: RvtTheme.rvtTheme,
        child: const Center(
          child: CircularProgressIndicator(),
        ),
      ),
      child: MaterialApp.router(
        routerConfig: router,
      ),
    ),
  );
}

void _initDeepLinkListener() {
  // 使用deep_link包监听链接变化
  final deepLink = DeepLink();
  
  // 处理实时收到的Deep Link跳转请求
  deepLink.addListener((url) {
    if (url == null) return;
    final uri = Uri.parse(url);
    _handleDeepLinkUri(uri);
  });
  
  // 处理应用启动时的初始Deep Link
  deepLink.getInitialLink().then((url) {
    if (url != null) {
      final uri = Uri.parse(url);
      _handleDeepLinkUri(uri);
    }
  });
}

void _handleDeepLinkUri(Uri uri) {
  if (uri.path.startsWith('/api/app/extevents/')) {
    final idStr = uri.pathSegments.last;
    Globals.extEventId = int.tryParse(idStr);
    // 主动触发路由跳转，强制GoRouter处理新路径
    router.go(uri.path);
  }
}

3. 调整GoRouter配置

final router = GoRouter(
  routes: [
    GoRoute(
      path: '/',
      builder: (_, __) => MyApp(), // 去掉const修饰
    ),
    GoRoute(
      path: '/api/app/extevents/:id1',
      builder: (_, state) {
        // 可选：如果需要直接从路由参数更新状态，可在此处理
        Globals.extEventId = int.tryParse(state.pathParameters['id1'] ?? '');
        return MyApp(); // 去掉const修饰
      },
    )
  ],
  onException: (context, state, router) => router.go('/'),
  // 可选：监听全局状态变化，自动刷新路由
  refreshListenable: ValueNotifier<int?>(Globals.extEventId),
);

额外建议 #

• 推荐使用状态管理工具（比如Provider、Riverpod）来管理extEventId这类全局状态，而非直接操作静态变量，避免状态混乱；
• 如果MyApp是StatelessWidget，建议改成StatefulWidget，在didChangeDependencies中监听Globals.extEventId的变化，触发UI更新。

内容的提问来源于stack exchange，提问作者E.Benedos