使用go_router 10.0.0时，push/pop导致导航栈所有页面重建如何解决？

针对你遇到的push/pop操作时导航栈所有页面重建、重复API调用及状态丢失问题，可通过以下几种方案解决：

1. 避免GoRouter实例被重复创建 #

你的代码中appRoutes是静态变量，但如果_intialRout(_hiveManager, _configRoute)依赖的状态发生变化，可能会触发GoRouter重新初始化，导致整个路由树重建。建议将GoRouter实例放在StatefulWidget的状态中初始化，确保仅在必要时更新：

class AppRouter extends StatefulWidget {
  const AppRouter({super.key});

  @override
  State<AppRouter> createState() => _AppRouterState();
}

class _AppRouterState extends State<AppRouter> {
  late final GoRouter _router;

  @override
  void initState() {
    super.initState();
    final initialPath = "/${_intialRout(_hiveManager, _configRoute)}";
    _router = GoRouter(
      navigatorKey: _navKey,
      initialLocation: initialPath,
      observers: AppConstant.navigatorObservers(),
      routerNeglect: true,
      routes: [
        // 原有的路由定义
        GoRoute(
          name: Routes.signInMethods,
          path: "/${Routes.signInMethods}",
          builder: (context, state) => const SignInMethodsScreen(),
        ),
        // ...其他路由
      ],
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp.router(routerConfig: _router);
  }
}

2. 用StatefulShellRoute保持页面状态（适用于底部导航场景） #

如果你的MainScreen是底部导航结构，改用StatefulShellRoute可以让各tab页面在切换时保持状态，不会被重建：

// 修改MainScreen对应的路由
GoRoute(
  name: Routes.mainScreen,
  path: "/${Routes.mainScreen}",
  pageBuilder: (context, state) => StatefulShellRoute.pageBuilder(
    builder: (context, state, navigationShell) => MainScreen(navigationShell: navigationShell),
    branches: [
      // 第一个tab的路由分支
      StatefulShellBranch(
        routes: [
          GoRoute(
            path: "home",
            builder: (context, state) => const HomeScreen(),
          ),
        ],
      ),
      // 其他tab的分支
      StatefulShellBranch(
        routes: [
          GoRoute(
            path: "profile",
            builder: (context, state) => const ProfileScreen(),
          ),
        ],
      ),
    ],
  ),
)

3. 给页面添加KeepAlive机制 #

即使是StatelessWidget，也可以通过AutomaticKeepAliveClientMixin让页面在离开导航栈时保留状态，避免重建：

// 将StatelessWidget改为StatefulWidget并混入KeepAlive
class SignInMethodsScreen extends StatefulWidget {
  const SignInMethodsScreen({super.key});

  @override
  State<SignInMethodsScreen> createState() => _SignInMethodsScreenState();
}

class _SignInMethodsScreenState extends State<SignInMethodsScreen> with AutomaticKeepAliveClientMixin {
  // 返回true表示需要保持状态
  @override
  bool get wantKeepAlive => true;

  @override
  Widget build(BuildContext context) {
    // 必须调用super.build(context)
    super.build(context);
    return const Scaffold(
      // 页面原有内容
    );
  }
}

4. 控制GoRouter的重建时机 #

通过refreshListenable参数指定GoRouter的重建触发条件，只有当指定的Listenable对象变化时才重建路由，避免不必要的全局重建：

// 示例：使用ValueNotifier作为refreshListenable
final refreshNotifier = ValueNotifier<int>(0);

GoRouter appRoutes = GoRouter(
  navigatorKey: _navKey,
  initialLocation: "/${_intialRout(_hiveManager, _configRoute)}",
  observers: AppConstant.navigatorObservers(),
  routerNeglect: true,
  refreshListenable: refreshNotifier, // 仅当notifier变化时重建
  routes: [/* 路由定义 */],
);

// 当需要主动触发路由重建时，更新notifier
refreshNotifier.value++;

内容的提问来源于stack exchange，提问作者Anas-Qasem