Flutter GoRouter无法导航至选中路由问题求助

API 探路者

2026-7-31

GoRouter导航失效排查方案

核对路由注册完整性
检查goRouterProvider.dart里CategoriesFeedScreen的路由注册，确保路径、参数（含命名参数）完全匹配导航时使用的规则。示例正确注册：

GoRoute(
  path: '/categories/:categoryId',
  // 若用命名路由需同步name参数
  name: 'categories',
  builder: (context, state) => CategoriesFeedScreen(
    categoryId: state.pathParameters['categoryId']!,
  ),
)

检查导航触发逻辑
确认CategoryWidget中导航代码调用正确的GoRouter方法，避免参数传递错误或方法误用：
```
// 路径导航
context.go('/categories/${category.id}');
// 或命名路由导航
context.goNamed('categories', params: {'categoryId': category.id});
```
注意不要混用push等可能导致栈层级异常的方法。
排查页面嵌套层级问题
如果CategoriesFeedScreen嵌套在ShellRoute或父路由下，导航路径必须包含父路由前缀。比如父路由为/home，完整导航路径应为/home/categories/:categoryId。

添加路由事件监听
在main.dart的GoRouter配置中加入导航监听，通过日志确认导航事件是否触发、目标路由是否被识别：

GoRouter(
  routes: [...],
  navigatorObservers: [
    NavigatorObserver(
      didPush: (route, previousRoute) {
        print('触发导航：${route.settings.name}，路径：${route.settings.name}');
      },
    ),
  ],
)

验证页面组件可用性
临时将CategoriesFeedScreen替换为极简测试页面，若测试页面能正常显示，说明原页面存在逻辑异常（如空指针、未捕获错误）：

class CategoriesFeedScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('测试分类页')),
      body: const Center(child: Text('页面正常加载')),
    );
  }
}