核心解决方案 #

1. 确保GoRouter单例的正确初始化 #

虽然你已尝试保证单例，但要确认实例是顶层全局变量，避免热重载时被重新创建：

// 必须在文件顶层定义，不要放在类或函数内部
late final GoRouter _router = GoRouter(
  initialLocation: '/',
  routes: [
    GoRoute(
      path: '/',
      builder: (context, state) => const HomePage(),
    ),
    GoRoute(
      path: '/details',
      builder: (context, state) => const DetailsPage(),
    ),
  ],
);

若初始化需要依赖上下文，不要在全局直接初始化，改用Provider或单例类管理，确保仅初始化一次。

2. 禁用路由配置变化时的强制重建 #

在GoRouter配置中添加rebuildRouteOnConfigChange: false，阻止热重载时重置路由栈：

final GoRouter _router = GoRouter(
  initialLocation: '/',
  rebuildRouteOnConfigChange: false, // 新增该参数
  routes: [
    // 你的路由配置
  ],
);

该参数默认值为true，热重载时哪怕路由配置无明显修改，也可能触发路由栈重置，导致应用回到初始页面。

3. 检查页面组件的热重载兼容性 #

确认页面组件无破坏热重载的逻辑：

• 不在build方法中创建全局状态或路由相关对象
• 页面保持使用const构造函数（你已实现）
• 状态管理逻辑需支持热重载时保留状态（比如用KeepAlive或状态库的持久化能力）

4. 升级GoRouter到最新稳定版 #

部分旧版本GoRouter存在热重载相关bug，直接升级可解决问题：

flutter pub upgrade go_router

额外排查点 #

若以上方法无效，检查以下内容：

• 确认MaterialApp.router直接使用全局_router，而非在build方法中重新创建GoRouter实例：

  class MyApp extends StatelessWidget {
    const MyApp({super.key});
  
    @override
    Widget build(BuildContext context) {
      return MaterialApp.router(
        routerConfig: _router, // 用全局实例，不要写GoRouter(...)
      );
    }
  }
  

• 检查自定义NavigatorObserver或RouteObserver是否在热重载时触发了页面跳转
• 关闭Flutter DevTools中"Track Widget Creation"等可能影响热重载的调试开关

内容的提问来源于stack exchange，提问作者soufiane ben yaala