Flutter GoRouter主路由Scaffold不显示问题求助

1. 检查主路由的页面配置 #

确认GoRouter中主路由/的builder返回的是完整的UserScreen组件，别误写成只返回组件内部的某个子元素（比如直接返回UserScreen().body）。正确配置示例：

final goRouter = GoRouter(
  initialLocation: '/',
  routes: [
    GoRoute(
      path: '/',
      builder: (context, state) => UserScreen(), // 这里必须返回完整组件
    ),
    // 子路由配置
    GoRoute(
      path: '/sub',
      builder: (context, state) => SubScreen(),
    ),
  ],
);

2. 排查UserScreen内部的条件渲染逻辑 #

检查UserScreen里的Scaffold是否对AppBar、bottomNavigationBar等元素做了路由相关的条件判断，比如：

// 错误示例：主路由下隐藏AppBar
AppBar: ModalRoute.of(context)?.settings.name == '/' ? null : AppBar(title: Text('用户页')),

如果有这类逻辑，直接移除或调整条件即可。

3. 核对MaterialApp.router的配置 #

确保MaterialApp.router没有设置home、initialRoute等会和GoRouter冲突的属性，正确配置如下：

MaterialApp.router(
  routerConfig: goRouter,
  // 不要添加home、initialRoute属性，路由逻辑完全交给GoRouter处理
  theme: ThemeData(primarySwatch: Colors.blue),
);

4. 检查是否存在嵌套MaterialApp #

如果UserScreen内部嵌套了另一个MaterialApp，会导致导航层级冲突，主路由的Scaffold可能被内层组件覆盖。直接移除嵌套的MaterialApp，统一用外层的MaterialApp.router即可。

5. 对比主路由与子路由的配置差异 #

把主路由和正常显示的子路由配置做对比，看是否主路由使用了不同的页面类型（比如误用CupertinoPage而非MaterialPage），或者在builder中有特殊处理逻辑，统一配置规则即可。

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