Flutter升级空安全后Navigator路由传参Null转ScreenArgs类型报错

错误触发存在两个核心原因：

• 你的generateRoute函数第一行就直接对settings.arguments做强制类型转换为ScreenArgs，但所有路由跳转（包括初始路由加载）只要没显式传arguments，这个值默认都是null，强转非空类型直接触发空安全校验报错
• 初始路由profileRoute加载时没有设置初始参数，应用启动阶段就会触发类型转换失败，还没到你点击底部导航跳转的执行步骤

• 第一种方案中你定义的全局args变量没有传递给路由系统：你写的onGenerateRoute: (args) {generateRoute(args);}里的args是函数形参，和外部变量重名被覆盖，同时没有给Navigator设置initialArguments参数，初始路由加载时参数还是null
• 第二种方案只修改了跳转逻辑，但应用启动时初始路由加载就已经触发报错，还没执行到点击跳转的代码

1. 调整路由参数获取逻辑，不要全局强转 #

只在需要参数的路由分支内做类型校验和转换，适配空安全规则：

Route<dynamic> generateRoute(RouteSettings settings) {
  switch (settings.name) {
    case profileRoute:
      // 该路由不需要参数，直接返回页面
      return PageTransition(
          child: const ProfileScreen(), type: PageTransitionType.fade);
    case coursesRoute:
      // 仅在需要参数的分支内做校验
      final args = settings.arguments as ScreenArgs?;
      // 防止空值，可以选择抛出自定义错误或者给默认参数
      if (args == null) {
        throw ArgumentError('coursesRoute必须传入ScreenArgs类型参数');
      }
      return PageTransition(
          child: CoursesScreen(
            entityId: args.entityId,
          ),
          type: PageTransitionType.fade);
    // 其他路由按照相同逻辑处理
  }
}

2. 补充所有必要的参数传递 #

• 如果初始路由需要参数，给Navigator添加initialArguments配置：

Navigator(
  key: _navigatorKey,
  initialRoute: profileRoute,
  // 如果初始路由需要参数就在这里传，不需要可以省略
  initialArguments: ScreenArgs("","",""),
  onGenerateRoute: generateRoute,
)

• 底部导航跳转需要参数的路由时，必须携带参数：

void _onItemTapped(int index) {
  setState(() {
    _screenIndex = index;
  });
  switch (index) {
    case 0:
      // 跳转coursesRoute必须传入符合业务要求的ScreenArgs实例
      _navigatorKey.currentState!.pushNamed(
        coursesRoute, 
        arguments: ScreenArgs("你的quizId", "你的entityId", "你的courseId")
      );
      break;
  }
}

3. 可选优化：调整ScreenArgs类适配空安全 #

如果部分参数允许为空，或者需要默认值，可以改成命名参数加默认值的写法，降低强转错误概率：

class ScreenArgs {
  final String quizId;
  final String courseId;
  final String entityId;
  final int numOfQuestions;

  ScreenArgs({
    this.quizId = '',
    this.entityId = '',
    this.courseId = '',
    this.numOfQuestions = numberOfQuestions,
  });
}

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