Flutter中如何在控制器中使用GoRouter实现无Context导航？

1. 正确配置全局Navigator Key #

在路由配置的全局位置（比如主文件或路由管理类）定义全局的NavigatorState Key，并在GoRouter初始化时绑定：

// 全局声明，确保全应用可访问
final GlobalKey<NavigatorState> rootNavigatorKey = GlobalKey<NavigatorState>();

// 初始化GoRouter时传入该Key
final GoRouter appRouter = GoRouter(
  navigatorKey: rootNavigatorKey,
  // 加载你的模块化路由集合
  routes: [
    ...RouterRegister.routes,
    ...MicroAuthRoutes.routes,
  ],
);

2. 控制器中直接调用导航 #

不需要依赖Context，直接通过全局Key或全局Router实例调用导航方法：

// 方式1：通过全局Key获取GoRouter实例
void navigateToLogin() {
  final context = rootNavigatorKey.currentContext;
  if (context != null) {
    GoRouter.of(context).push('/login');
  }
}

// 方式2：直接调用全局Router实例的方法（更简洁）
void navigateToHome() {
  appRouter.go('/home');
}

3. 空安全优化 #

为避免currentContext为空导致报错，可增加非空判断，或者在应用初始化完成后再调用导航逻辑（比如控制器绑定到页面生命周期后）。

4. 模块化路由适配 #

确保你的RouterRegister、MicroAuthRoutes类返回的路由列表能正确合并到全局appRouter的routes参数中，比如通过静态方法暴露路由集合：

// 示例：MicroAuthRoutes类的路由定义
class MicroAuthRoutes {
  static List<RouteBase> get routes => [
        GoRoute(
          path: '/login',
          builder: (context, state) => const LoginPage(),
        ),
      ];
}

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