如何解决GoRouter中RouteObserver无法捕获go/goNamed同级路由跳转问题？

问题根源 #

第三方导航观察者（如SentryNavigatorObserver、FirebaseAnalyticsObserver）默认只实现了didPush、didPop这类对应栈压入/弹出操作的回调，但go方法（常见于GoRouter或自定义同级路由跳转）本质是替换当前路由，会触发didReplace回调——多数第三方观察者没有重写这个方法，因此无法捕获这类跳转。

解决方案 #

自定义一个NavigatorObserver，覆盖所有路由变更相关的回调，包括didReplace，在回调中实现你的路由追踪逻辑。

1. 自定义路由观察者 #

class FullRouteObserver extends NavigatorObserver {
  // 处理push跳转
  @override
  void didPush(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPush(route, previousRoute);
    _trackRouteChange(previousRoute?.settings.name, route.settings.name);
  }

  // 处理pop跳转
  @override
  void didPop(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didPop(route, previousRoute);
    _trackRouteChange(route.settings.name, previousRoute?.settings.name);
  }

  // 处理go方法触发的路由替换
  @override
  void didReplace({Route<dynamic>? newRoute, Route<dynamic>? oldRoute}) {
    super.didReplace(newRoute: newRoute, oldRoute: oldRoute);
    _trackRouteChange(oldRoute?.settings.name, newRoute?.settings.name);
  }

  // 处理路由移除的情况（可选）
  @override
  void didRemove(Route<dynamic> route, Route<dynamic>? previousRoute) {
    super.didRemove(route, previousRoute);
    _trackRouteChange(route.settings.name, previousRoute?.settings.name);
  }

  // 核心追踪逻辑，替换成你的工具上报代码
  void _trackRouteChange(String? from, String? to) {
    if (from != null && to != null) {
      print('路由跳转: $from -> $to');
      // 例如：yourTrackingTool.trackRoute(from, to);
    }
  }
}

2. 集成到导航组件 #

原生Navigator场景

MaterialApp(
  navigatorObservers: [FullRouteObserver()],
  // 其他配置
)

GoRouter场景

GoRouter的go方法本质是触发路由替换，上述自定义观察者的didReplace会被自动调用，只需将观察者加入observers列表：

final GoRouter router = GoRouter(
  routes: [
    // 你的路由配置
    GoRoute(path: '/pageA', builder: (context, state) => PageA()),
    GoRoute(path: '/pageB', builder: (context, state) => PageB()),
  ],
  observers: [FullRouteObserver()],
);

额外注意事项 #

• 确保所有路由都设置了name（或在GoRouter中配置了path），否则无法获取有效的路由标识。
• 如果使用其他路由管理库，可查看其文档确认路由变更对应的回调事件，针对性实现追踪逻辑。

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