Flutter调用pushReplacementNamed跳转首页仍重复显示OnBoarding引导页

• 路由配置逻辑冲突：你将首页路由绑定在/路径上，同时/作为应用根路由，本身的生成逻辑是依赖SharedPreferences标记动态决定返回OnBoarding还是HomePage。当你在引导完成时调用pushReplacementNamed('/')，路由系统会重新触发一遍/的生成逻辑，重新读取存储标记做页面判定。
• 异步时序错位：SharedPreferences的读写是异步跨通道操作，你在onDone回调中写入标记为false时没有加await等待写入完成，就直接执行路由跳转。此时路由生成逻辑读取标记时，拿到的还是写入前的旧值true，自然会重新返回引导页。
• 流程冗余：引导页完成后跳回/根路由重新走全量启动判定，相当于形成路由循环，除了增加时序故障风险没有实际价值。

• 修正异步操作时序
  将onDone回调改造为async方法，在写入SharedPreferences标记时加await，确保存储操作完全生效后再执行导航。参考实现：

  onDone: () async {
    final prefs = await SharedPreferences.getInstance();
    // 等待标记持久化完成
    await prefs.setBool('shouldShowOnboardingPage', false);
    // 跳转前校验上下文挂载状态，避免异步过程中页面销毁引发报错
    if (context.mounted) {
      Navigator.of(context).pushReplacementNamed('/home');
    }
  }
  

• 调整路由结构消除逻辑冲突
  • 将首页的独立路由路径从/修改为/home，不再把首页组件和根路由绑定
  • routes.dart中/根路由的生成逻辑，仅保留启动判定能力：等SharedPreferences读取完成后，根据标记值直接导航到对应路径（标记为true则跳/onboarding，为false则跳/home），不要在根路由的生成函数里直接返回具体页面组件
• 移除冗余跳转
  路由结构改造完成后，引导页onDone回调直接跳独立的/home路由即可，不需要再跳回/重新走启动判定流程，从根源上避免引导页循环加载的问题。

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