AutoRoute库中重定向路由丢失QueryParams问题解析

问题背景

在使用AutoRoute路由库进行Flutter应用开发时，开发者从8.3.0版本升级到9.3.0+1版本后，发现了一个关于路由重定向时查询参数丢失的问题。具体表现为：当使用RedirectRoute进行路径重定向时，原始URL中的查询参数无法传递到目标路由。

问题复现

典型的场景配置如下：

RedirectRoute(path: '/magic-link', redirectTo: '/login'),
AutoRoute(
  path: '/login',
  page: LoginRoute.page,
  initial: true,
),

当用户访问类似http://whatever.com/magic-link?token=something的深度链接时，期望LoginPage能够接收到token参数，但实际上该参数始终为null。

问题分析

这个问题在AutoRoute 9.3.0+1版本中出现，主要涉及路由重定向机制的变化。在重定向过程中，查询参数没有被正确保留和传递。这是一个重要的功能退化，因为查询参数在深度链接场景中经常用于传递一次性令牌、认证信息等关键数据。

临时解决方案

开发者提供了一个有效的临时解决方案，通过自定义深度链接构建器来手动处理特定路径的重定向：

FutureOr<DeepLink> deeplinkBuilder(PlatformDeepLink deeplink) {
    if (deeplink.uri.path == "/magic-link") {
      final token = deeplink.uri.queryParameters["token"];
      return DeepLink.single(LoginRoute(token: token));
    }
    saveCurrentDeeplink(deeplink.uri);
    return deeplink;
}

这种方法虽然有效，但需要为每个可能的重定向路径编写特定代码，增加了维护成本。

官方修复

根据仓库所有者的回复，这个问题已经在AutoRoute的第10个主要版本中得到修复。这意味着：

1. 升级到v10后，重定向路由将能够正确保留查询参数
2. 不再需要手动处理查询参数的传递
3. 原始的重定向配置可以正常工作

升级建议

对于遇到此问题的开发者，建议：

1. 评估升级到AutoRoute v10的可行性
2. 如果暂时无法升级，可以采用上述的临时解决方案
3. 在测试环境中充分验证深度链接功能，确保所有查询参数都能正确传递

总结

路由参数传递是Flutter应用中深度链接功能的核心部分。AutoRoute库在版本迭代过程中出现的这个查询参数丢失问题，提醒我们在升级路由库时需要特别注意深度链接功能的回归测试。随着v10版本的发布，这个问题已经得到官方修复，开发者可以根据项目实际情况选择合适的解决方案。