Flutter 3升级后auto_route导航键currentState为空问题求助

1. 修正GlobalKeys的单例实现 #

首先确保GlobalKeys是单例模式，避免因多实例导致navigatorKey不匹配：

class GlobalKeys {
  static final GlobalKeys _instance = GlobalKeys._();
  GlobalKeys._();
  factory GlobalKeys() => _instance;

  final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();
}

2. 正确配置MaterialApp.router与AutoRoute #

MaterialApp.router不直接通过key参数绑定导航键，需将navigatorKey关联到AutoRoute生成的AppRouter实例中：

步骤2.1 初始化AppRouter并关联navigatorKey #

如果使用get_it依赖注入，先注册单例：

// 依赖注入初始化代码
getIt.registerSingleton<AppRouter>(
  AppRouter(navigatorKey: GlobalKeys().navigatorKey)
);

若不使用get_it，直接创建全局实例：

final appRouter = AppRouter(navigatorKey: GlobalKeys().navigatorKey);

步骤2.2 配置MaterialApp.router #

将AppRouter的delegate和routeInformationParser传入：

MaterialApp.router(
  routerDelegate: appRouter.delegate(),
  routeInformationParser: appRouter.defaultRouteParser(),
  // 其他配置（主题、本地化等）
);

3. 修复navigatorKey.currentState为空问题 #

现在GlobalKeys().navigatorKey已与AppRouter的导航器绑定，调用导航时做非空校验：

dynamic redirectTo(String path) async {
  final navigatorState = GlobalKeys().navigatorKey.currentState;
  if (navigatorState != null) {
    navigatorState.pushNamed(path);
  } else {
    print("Navigator state为空，请检查AppRouter配置");
  }
}

4. 解决getIt().pushNamed无效问题 #

• 确保get_it注册的是单例（使用registerSingleton），且MaterialApp.router使用的是同一个实例，避免重新创建
• 检查路由路径/名称是否正确：AutoRoute生成的路由名称对应路由类的name属性（如HomeRoute.name），或使用路由定义的路径字符串（如'/home'）

5. 版本兼容性检查 #

确保auto_route依赖适配Flutter 3，更新pubspec.yaml：

dependencies:
  auto_route: ^7.3.0 # 替换为最新兼容版本

dev_dependencies:
  auto_route_generator: ^7.1.0 # 与auto_route版本匹配
  build_runner: ^2.4.0

重新生成路由代码：

flutter pub run build_runner build --delete-conflicting-outputs

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