Flutter切换命名路由后出现Null check operator used on a null value报错
核心问题定位
- 路由表配置不符合Flutter内置规范,是触发报错的根本原因。此前使用
MaterialPageRoute直接传入Widget实现跳转时,完全不依赖全局路由表的匹配逻辑,因此代码运行完全正常;切换到命名路由后,路由匹配规则被触发,才暴露了配置错误。 - 具体配置错误点:当前定义的路由键为
'somePage/',将分隔斜杠放在了字符串末尾,而Flutter要求所有命名路由的键必须以斜杠开头。当系统匹配路由时,会因为找不到和路径规则对齐的路由项返回空值,_onGenerateRoute方法内部对这个空结果直接使用了!空检查操作符,最终抛出Null check operator used on a null value的类型转换错误。 - 多轮热重启时好时坏的特殊现象来源:热重启过程中,Flutter引擎会短暂残留上一次运行时缓存的路由索引。缓存未被清空时应用可以正常加载,缓存被完全重建时就会触发上述空值报错,因此表现为“某一次热重启正常、下一次热重启直接崩溃”的不稳定状态。
具体修复步骤
- 调整路由键的书写格式,把斜杠从字符串末尾移到开头,修正错误的路由配置:
错误写法示例:
修正后正确写法:routes: { '/': (context) => Wrapper(), 'somePage/': (context) => SomePage(), },routes: { '/': (context) => Wrapper(), '/somePage': (context) => SomePage(), }, - 补充说明:当前使用的Flutter 2.0.2稳定版本本身存在路由解析的边界逻辑漏洞,上述路由格式问题是触发崩溃的核心诱因;如果调整格式后仍偶现同类报错,可以在不升级大版本的前提下,更新到同稳定通道的最新小版本,规避官方已修复的路由解析bug。
内容的提问来源于stack exchange,提问作者Omar Fayad
相关产品推荐
相关产品推荐

