如何在AutoRoute中指定必填参数？解决RouteArgs非空报错问题

针对你遇到的问题，除了将参数设为可选，还有以下几种可行方案：

方案一：通过依赖注入（DI）获取依赖，替代路由传参 #

对于loadData这类无法通过URL序列化的函数参数，更合理的方式是通过依赖注入容器提供，而非路由传递。这样路由无需携带参数，Web刷新或设为初始路由时也不会报错。

示例（以get_it为例）：

1. 注册依赖：

final getIt = GetIt.instance;

void setupDI() {
  getIt.registerLazySingleton<Function()>(() => () {
    // 这里是你的loadData逻辑
    print('加载数据');
  });
}

2. 修改页面，从DI获取参数：

@RoutePage()
class ProfilePage extends StatelessWidget {
  final Function() loadData;

  const ProfilePage({
    Key? key,
  }) : loadData = getIt<Function()>(),
       super(key: key);

  @override
  Widget build(BuildContext context) {
    // 使用loadData
    return Scaffold(body: ElevatedButton(onPressed: loadData, child: const Text('加载')));
  }
}

3. 路由配置保持原有写法即可：

AutoRoute(
  path: '/profile',
  page: ProfileRoute.page,
),

方案二：利用extra传递参数+路由守卫处理缺失 #

通过extra传递必填参数，同时添加路由守卫检查参数是否存在，若缺失则重定向到其他页面，避免报错。

1. 添加路由守卫：

class ProfileGuard extends AutoRouteGuard {
  @override
  void onNavigation(NavigationResolver resolver, StackRouter router) {
    if (resolver.args.extra is Function()) {
      resolver.next(true);
    } else {
      // 参数缺失时重定向到首页或其他页面
      router.replace(const HomeRoute());
    }
  }
}

2. 配置路由时添加守卫：

AutoRoute(
  path: '/profile',
  page: ProfileRoute.page,
  guards: [ProfileGuard()],
),

3. 导航时通过extra传参：

context.pushRoute(ProfileRoute(extra: () {
  // loadData逻辑
}));

4. 页面中获取extra参数：

@RoutePage()
class ProfilePage extends StatelessWidget {
  final Function() loadData;

  const ProfilePage({
    Key? key,
    required this.loadData,
  }) : super(key: key);

  factory ProfilePage(BuildContext context) {
    final args = context.routeData.args;
    return ProfilePage(
      loadData: args.extra as Function(),
    );
  }

  @override
  Widget build(BuildContext context) {
    // 使用loadData
    return Scaffold();
  }
}

方案三：自定义路由参数的可空性并处理缺失逻辑 #

通过auto_route的注解配置，让生成的路由参数类允许参数为null，然后在页面内部处理参数缺失的情况（比如从DI获取默认实现）。

1. 修改页面参数的注解：

@RoutePage()
class ProfilePage extends StatelessWidget {
  @Argument.nullable() // 标注参数为可空
  final Function()? loadData;

  // 在构造函数中处理默认值，比如从DI获取
  const ProfilePage({
    Key? key,
    this.loadData,
  }) : super(key: key);

  @override
  Widget build(BuildContext context) {
    final effectiveLoadData = loadData ?? getIt<Function()>();
    // 使用effectiveLoadData
    return Scaffold();
  }
}

这样即使路由参数为null，页面也能通过默认值正常初始化，Web刷新或设为初始路由时不会报错。

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