Flutter使用Navigator 2.0手动改浏览器URL报错及返回键异常问题

1. 手动修改URL匹配失败问题 #

该问题确实和Parser的校验逻辑直接相关。你最初的switch判断直接使用routeInformation.location做全路径匹配，存在两个隐性问题：

• 当URL携带查询参数、末尾带斜杠时（比如/retailers?id=3、/retailers/），全路径匹配会直接失效，进入default分支返回HomePath，就会触发「无对应路由」的报错
• 你修改为用uri.pathSegments.first匹配的逻辑是正确的，能够忽略参数、末尾斜杠的影响，所以返回键功能恢复属于正常结果

2. Duplicate GlobalKey报错原因 #

该报错和Parser逻辑无关，是RouterDelegate的页面构建逻辑导致的：
你在AppState更新selectedPage触发delegate重绘时，没有对已存在的页面实例做去重处理，每次都新增携带相同GlobalKey的页面Widget到导航栈中，就会触发全局Key重复的报错。
有两种修复方向可选：

• 每次构建导航栈时，仅保留当前选中页面对应的单个页面实例，不叠加旧页面
• 如果需要保留栈结构，要给每个页面对象生成唯一的Key，不要复用同一个GlobalKey

3. 首次加载循环调用问题 #

你观察到的重复调用restoreRouteInformation的问题，是因为你在setNewRoutePath里更新AppState的selectedPage后，触发RouterDelegate重绘，currentConfiguration被再次读取，又触发了restore方法，形成不必要的循环。
修复方案：在setNewRoutePath中先判断传入的路径和当前AppState已有的selectedPage是否一致，仅在不一致时才更新AppState，即可打断循环：

@override
Future<void> setNewRoutePath(RoutePath path) async {
  if (path.selectedPath == appState.selectedPage) {
    return;
  }
  appState.updateSelectedPage(path.selectedPath);
}

4. Parser逻辑优化建议 #

建议你把Parser中的switch统一改成基于pathSegments的匹配，同时兼容根路径场景：

@override
Future<RoutePath> parseRouteInformation(
    RouteInformation routeInformation) async {
  final Uri uri = Uri.parse(routeInformation.location ?? '/');
  if (uri.pathSegments.isEmpty) {
    return HomePath();
  }
  switch (uri.pathSegments.first) {
    case 'cyclists':
      return CyclistsPath();
    case 'retailers':
      return RetailersPath();
    // 其余路径依次匹配，注意此处不要带前缀斜杠
    default:
      return HomePath();
  }
}

调整后无论URL带不带参数、末尾带不带斜杠，都能正常匹配到对应路由。

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