Flutter在initState中调用Navigator报错，已尝试两种方法未解决

错误原因 #

你遇到的问题是调用Navigator.pushReplacement时使用的context不属于Navigator组件的后代节点，导致Flutter找不到路由导航器实例。

解决方案 #

1. 修正App根组件结构 #

确保加载页面被包裹在MaterialApp（或CupertinoApp）内部——这两个组件默认集成了Navigator，能为子组件提供合法的导航上下文。

错误的根结构示例：

void main() => runApp(LoadingPage());

正确的根结构：

void main() => runApp(MaterialApp(home: LoadingPage()));

调整后LoadingPage的context会成为Navigator的后代，即可正常调用导航方法。

2. 使用GlobalKey直接获取Navigator状态 #

如果根结构没问题，或需要脱离当前context完成跳转，可以通过GlobalKey直接绑定并调用Navigator：

步骤1：定义全局Key

在App入口或LoadingPage中声明：

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

步骤2：绑定到MaterialApp

void main() => runApp(
  MaterialApp(
    navigatorKey: navigatorKey, // 关联全局Key
    home: LoadingPage(),
  ),
);

步骤3：通过Key执行跳转

修改loadData方法：

void loadData() async {
  await MyHttpRequests(); // 补充分号，确保API请求执行完成
  await Future.delayed(const Duration(seconds: 1));
  navigatorKey.currentState?.pushReplacement(
    PageRouteBuilder(
      pageBuilder: (context, animation, secondaryAnimation) => const HomePage(),
      transitionsBuilder: (context, animation, secondaryAnimation, child) => child,
      transitionDuration: const Duration(milliseconds: 0),
    ),
  );
}

3. 通过Builder获取合法上下文 #

如果坚持使用当前页面的context，可以在build方法中用Builder组件获取Navigator后代的上下文，再执行跳转：

@override
Widget build(BuildContext context) {
  return Scaffold(
    body: Builder(
      builder: (navContext) {
        // 此处navContext为Navigator的后代上下文
        WidgetsBinding.instance.addPostFrameCallback((_) {
          loadData(navContext);
        });
        return const Center(child: CircularProgressIndicator());
      },
    ),
  );
}

// 修改loadData接收合法上下文参数
void loadData(BuildContext navContext) async {
  await MyHttpRequests();
  await Future.delayed(const Duration(seconds: 1));
  Navigator.pushReplacement(
    navContext,
    PageRouteBuilder(
      pageBuilder: (context, animation, secondaryAnimation) => const HomePage(),
      transitionsBuilder: (context, animation, secondaryAnimation, child) => child,
      transitionDuration: const Duration(milliseconds: 0),
    ),
  );
}

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