Flutter页面返回触发WillPopScope断言失败及GlobalKey重复错误求解

报错原因 #

你遇到的两个报错属于同源问题，核心是组件生命周期和路由生命周期不匹配，具体如下：

• 重复GlobalKey报错：你将表单的GlobalKey以响应式变量的形式存放在OrdersMainController中，而GetX默认的Controller生命周期和页面解绑，不会随着页面销毁而自动重置。当你从Screen C直接返回Screen A时，Screen B（订单页）的组件树已经被销毁，但Controller里仍然持有旧的formKey实例，下次进入订单页或者路由栈更新时，同一个Key会被重复挂载到组件树，触发重复GlobalKey报错。
• WillPopScope断言失败：FormBuilder组件默认内置了WillPopScope用于拦截返回事件处理表单未保存提示，当你跨级从C直接返回A时，Screen B的WillPopScope状态实例还没来得及销毁，但它绑定的路由已经被从路由栈中移除，ModalRoute.of(context)拿到的路由实例和之前存储的_route不一致，就触发了源码135行的断言校验失败。

修复方案 #

1. 处理GlobalKey生命周期不匹配问题
   • 取消formKey的响应式包装，也不要将它存放在全局Controller中：GlobalKey是和组件生命周期强绑定的对象，你可以直接将它定义在订单页对应的StatefulWidget的State中，随页面创建和销毁。
   • 如果你必须要在Controller中持有formKey，请将OrdersMainController设置为页面级控制器：在页面绑定Controller时设置permanent: false，同时在Controller的onClose生命周期方法中清空formKey的引用，确保页面销毁时Key同步释放。
2. 处理WillPopScope断言问题
   • 如果你不需要表单拦截返回事件，可以给FormBuilder组件增加参数onWillPop: null，组件内部就不会创建WillPopScope，从根源避免这个断言报错。
   • 如果你需要保留表单返回拦截能力，跳转逻辑中避免直接跨级pop多个页面，改用GetX提供的Get.offNamedUntil清空路由栈的方式跳转到目标页面，避免中间页面的路由被提前销毁。
3. 优化侧边栏跳转逻辑
   现在侧边栏用Get.toNamed("/orders")每次点击都会push新的订单页到路由栈，会加剧Key重复问题，建议改成Get.offNamedUntil("/orders", (route) => route.settings.name == "/orders" ? false : true)，确保路由栈中只会存在一个订单页实例。

内容的提问来源于stack exchange，提问作者emirşah erden