Flutter使用onGenerateRoute传参报错：Null不是Map子类型

核心根因 #

你遇到的Null is not a subtype of Map<dynamic, dynamic>错误，本质是Dart 3.x严格空安全机制下，未对settings.arguments的null场景做处理：

• RouteSettings.arguments的类型是Object?，天生允许为null（比如直接通过路由名访问子页面、传参逻辑异常等场景都会导致其为null）。
• 如果你直接将settings.arguments强制转换为非空的Map类型（比如Map args = settings.arguments as Map;），一旦arguments为null，类型转换就会失败，触发上述错误。
• 你打印看到参数存在，只是测试时的正常场景，但代码没有覆盖null场景，导致程序仍会报错。

代码修正示例 #

假设你的原有代码存在上述问题，以下是针对性的修正：

1. 修正onGenerateRoute中的参数提取逻辑 #

Route<dynamic> generateRoute(RouteSettings settings) {
  switch (settings.name) {
    case '/second':
      // 处理null情况，给默认空Map避免类型错误
      final args = settings.arguments as Map<dynamic, dynamic>? ?? {};
      return MaterialPageRoute(
        builder: (context) => SecondPage(args: args),
      );
    // 更严谨的类型检查写法（可选）
    // case '/second':
    //   if (settings.arguments is Map) {
    //     final args = settings.arguments as Map<dynamic, dynamic>;
    //     return MaterialPageRoute(builder: (context) => SecondPage(args: args));
    //   } else {
    //     // 参数不符合预期时返回带默认值的页面
    //     return MaterialPageRoute(builder: (context) => const SecondPage(args: {}));
    //   }
    default:
      return MaterialPageRoute(builder: (context) => const HomePage());
  }
}

2. 增强子页面的参数鲁棒性 #

class SecondPage extends StatelessWidget {
  // 给参数设置默认空Map，避免必须传参
  final Map<dynamic, dynamic> args;
  const SecondPage({super.key, this.args = const {}});

  @override
  Widget build(BuildContext context) {
    // 取值时也处理null，避免key不存在时的错误
    final title = args['title'] ?? 'Default Title';
    return Scaffold(
      appBar: AppBar(title: Text(title)),
    );
  }
}

3. 主页面跳转代码（保持即可） #

ElevatedButton(
  onPressed: () {
    Navigator.pushNamed(
      context,
      '/second',
      arguments: {'title': 'pass parameter in named route'},
    );
  },
  child: const Text('Go to Second Page'),
)

总结 #

解决问题的关键是在空安全规则下，必须处理settings.arguments为null的情况，不能直接强制转换为非空的Map类型。通过给参数设置默认值、增加类型检查，可以彻底避免这类类型错误，同时提升代码的鲁棒性。

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