参数变化时如何刷新当前路由？auto_route同路由不同参数页面不更新怎么办

auto_route默认的路由匹配逻辑仅判断路由名称/基础路径是否一致，不会默认对比路径参数、URL查询参数的差异。当跳转的目标路由和当前路由栈顶的路由类型一致时，默认不会触发新页面实例的压入，也不会重建现有页面Widget，Flutter侧也会因为Widget的runtimeType和key没有变化，不会触发页面的生命周期重建回调，因此新参数不会被感知，页面也不会更新。

• 强制压入新路由实例
  跳转时在push方法中加入force: true参数，即可强制让auto_route即使识别到同类型路由也压入新的页面实例，触发完整的页面重建逻辑，代码示例：

  context.pushRoute(
    UserRoute(userId: 123),
    force: true,
  );
  

  该配置仅对单次跳转生效，适合偶发的同路由跳转场景。

• 监听路由参数变化局部更新
  如果不需要重建整个页面，可在页面内监听routeData的参数变化，在参数变更时仅更新需要变化的局部逻辑，性能开销更低，StatefulWidget实现示例：

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    // 监听路由参数变化
    final userId = context.routeData.queryParams.get('userId');
    // 拿到新参数后更新页面状态
    if (userId != _currentUserId) {
      setState(() {
        _currentUserId = userId;
        // 执行对应数据刷新逻辑
      });
    }
  }
  

• 全局配置路由参数匹配规则
  如果需要让auto_route全局将不同参数的同基础路径路由视为不同路由，可在定义路由时将参数声明到路径中，示例：

  @RoutePage(path: '/user/:userId')
  class UserPage extends StatelessWidget {
    const UserPage({@pathParam required this.userId, super.key});
    final int userId;
  }
  

  配置后跳转/user/1和/user/2会被auto_route识别为不同路由，自动触发页面重建，无需额外加跳转参数。

• 替换当前路由实例
  如果不需要保留当前同路由的栈记录，可使用replaceRoute或者replaceNamed方法，直接替换当前栈顶的路由实例为带新参数的实例，也会触发页面更新。

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