Flutter升级空安全后报错：期望Map<String,String?>类型却得到Null

错误原因 #

升级到空安全后，Dart的类型检查逻辑变得严格：

• 你用!强制断言ModalRoute.of(context)不为null，但真正触发错误的是settings.arguments——当跳转该路由时未传入参数，arguments本身就是Null，而你通过as Map<String, String?>强制将null转换为非空Map类型，这直接导致了类型不匹配错误。
• 升级前非空安全模式下，Dart会隐式忽略这类null的类型检查，所以代码能正常运行；但空安全后这种隐式处理被移除，必须显式处理所有可能的null场景。

修复方案 #

根据你的业务场景选择以下方式：

场景1：该路由必须传入参数 #

确保所有跳转到该路由的代码都传入符合类型要求的arguments，示例：

Navigator.pushNamed(
  context,
  '/target_route',
  arguments: {"id": "123", "name": null}, // 匹配Map<String, String?>类型
);

此时你原有的升级后代码可以正常运行，但建议把!替换为?.（更安全，避免上下文找不到路由的极端情况）。

场景2：该路由允许不传入参数 #

修改代码显式处理null情况，有两种常用写法：

1. 允许args为null类型：

final Map<String, String?>? args = ModalRoute.of(context)?.settings.arguments as Map<String, String?>?;

后续使用args时需要判断是否为null，比如通过args?['id']的方式取值。

2. 给args设置默认空Map：

final Map<String, String?> args = ModalRoute.of(context)?.settings.arguments as Map<String, String?>? ?? {};

这样即使没有传入参数，args也会是一个空Map，后续可以直接使用args['id']而无需额外判断null。

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