GoRouter路由问题：ListView向子路由传对象及feeDetails匹配报错解决

一、解决GoRouter "no initial match found for feeDetails" 报错 #

这个错误核心是初始路由未在路由表中定义，或路由路径配置存在拼写/结构错误，按以下步骤排查修复：

1. 确认initialLocation指向路由表中已存在的路径，不要直接将初始路由设为/feeDetails，除非已明确定义该路径：

   final GoRouter router = GoRouter(
     initialLocation: '/', // 初始路由设为已定义的列表页/首页
     routes: [
       GoRoute(path: '/', builder: (ctx, state) => YourListViewPage()),
       GoRoute(
         path: '/feeDetails',
         builder: (ctx, state) => FeeDetailsPage(),
       ),
     ],
   );
   

2. 检查feeDetails路由的路径拼写：确保路径开头带斜杠（/feeDetails而非feeDetails）；如果是嵌套路由，要保证父路由路径正确，比如父路由是/home，子路由需写成/home/feeDetails，导航时使用完整路径。
3. 避免路由路径冲突：确保没有重复定义相同路径的路由，参数占位符（如:id）使用正确。

二、ListView向子路由传递对象 #

GoRouter传递对象有3种实用方案，按需选择：

方案1：使用extra参数（最直接） #

在ListView点击事件中通过extra传递对象：

ListView.builder(
  itemCount: dataList.length,
  itemBuilder: (ctx, index) {
    final targetObj = dataList[index];
    return ListTile(
      onTap: () => context.go('/feeDetails', extra: targetObj),
      title: Text(targetObj.name),
    );
  },
);

子路由页面获取对象：

class FeeDetailsPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final targetObj = GoRouterState.of(context).extra as YourObjectType;
    // 使用对象渲染页面
    return Scaffold(body: Text(targetObj.detail));
  }
}

注意：自定义对象不要包含不可序列化类型（如BuildContext），复杂对象需提前转为可序列化模型类。

方案2：全局状态管理（适合复杂场景） #

如果项目已使用Provider、Riverpod或Bloc，直接将选中对象存入全局状态，子路由从状态读取：

// ListView中更新状态
onTap: () {
  context.read<YourStateNotifier>().selectObject(targetObj);
  context.go('/feeDetails');
}

// 子路由中读取
final selectedObj = context.watch<YourStateNotifier>().selectedObj;

方案3：JSON序列化传递（适合简单对象） #

将对象转为JSON字符串作为查询参数传递，子路由再解析：

// ListView中导航
onTap: () {
  final objJson = jsonEncode(targetObj.toJson());
  context.go('/feeDetails?obj=$objJson');
}

// 子路由中解析
final objJson = GoRouterState.of(context).queryParams['obj'];
final targetObj = YourObjectType.fromJson(jsonDecode(objJson!));

要求对象实现toJson()和fromJson()方法（可通过json_serializable自动生成）。

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