Flutter无上下文导航跳转维护页时异常的解决咨询

问题场景 #

我在MaintenanceController中用RxBool维护isMaintenance状态，通过ever监听状态变化跳转页面，功能正常但日志持续抛出"contextless navigation"异常。相关代码如下：

Controller代码 #

class MaintenanceController extends GetxController {
  RxBool isMaintenance = false.obs;

  @override
  onInit() {
    super.onInit();
    ever(
        isMaintenance,
        (_) => {
              if (isMaintenance.value) {Get.offNamed(Routes.maintenance)} else {Get.offNamed(Routes.splash)}
            });
  }
}

GetMaterialApp配置 #

GetMaterialApp(
      debugShowCheckedModeBanner: false,
      locale: Get.find<LocalizationController>().deviceLocale,
      getPages: Routes.routes,
      localizationsDelegates: AppLocalizations.localizationsDelegates,
      supportedLocales: AppLocalizations.supportedLocales,
      unknownRoute: Routes.getNotFound,
      initialRoute: GetPlatform.isWeb ? Routes.initial : Routes.splash,
      theme: Get.find<ThemeController>().themeData,
      navigatorKey: NavigationService.navigatorKey,
    );

异常日志 #

flutter: You are trying to use contextless navigation without
a GetMaterialApp or Get.key.
If you are testing your app, you can use:
[Get.testMode = true], or if you are running your app on
a physical device or emulator, you must exchange your [MaterialApp]
for a [GetMaterialApp].
...（堆栈信息省略）

尝试改用Get.key和navigatorKey.currentState!.pushNamed导航，但currentState始终为null。

问题原因 #

1. 初始化时机冲突：Controller的onInit方法执行时，GetMaterialApp的导航栈还未完全初始化完成，此时调用Get.offNamed会导致Get无法找到有效的导航上下文，虽然最终导航能生效，但会抛出异常。
2. NavigatorKey冲突：手动指定自定义navigatorKey会覆盖Get默认绑定的Get.key，导致Get无法关联到正确的导航栈状态，进而出现currentState为null的情况。

解决方案 #

1. 移除自定义NavigatorKey，使用Get默认Key #

GetMaterialApp默认会自动绑定Get.key，无需手动指定自定义navigatorKey，移除后Get能正确关联导航栈：

GetMaterialApp(
  debugShowCheckedModeBanner: false,
  locale: Get.find<LocalizationController>().deviceLocale,
  getPages: Routes.routes,
  localizationsDelegates: AppLocalizations.localizationsDelegates,
  supportedLocales: AppLocalizations.supportedLocales,
  unknownRoute: Routes.getNotFound,
  initialRoute: GetPlatform.isWeb ? Routes.initial : Routes.splash,
  theme: Get.find<ThemeController>().themeData,
  // 移除自定义navigatorKey配置
);

2. 延迟导航操作，确保上下文初始化完成 #

在ever的回调中，通过WidgetsBinding.instance.addPostFrameCallback等待当前帧绘制完成，此时导航栈已初始化完毕，再执行导航操作：

class MaintenanceController extends GetxController {
  RxBool isMaintenance = false.obs;

  @override
  void onInit() {
    super.onInit();
    ever(isMaintenance, (bool newValue) {
      // 等待UI帧绘制完成，确保导航上下文可用
      WidgetsBinding.instance.addPostFrameCallback((_) {
        // 额外判断上下文是否存在，避免空安全问题
        if (Get.context != null) {
          newValue ? Get.offNamed(Routes.maintenance) : Get.offNamed(Routes.splash);
        }
      });
    });
  }
}

3. （可选）若必须使用自定义NavigatorKey #

如果业务需要保留自定义navigatorKey，需将其赋值给Get.key，确保Get能关联到正确的导航栈：

void main() {
  // 初始化自定义navigatorKey并绑定到Get.key
  NavigationService.navigatorKey = GlobalKey<NavigatorState>();
  Get.key = NavigationService.navigatorKey;
  
  runApp(MyApp());
}

内容的提问来源于stack exchange，提问作者Răzvan Puiu