如何修复Flutter中'renderer.parent != null'断言失败问题？

报错日志 #

[日志] onChange Change { currentState: HomeState.pageChangedState(index: 1, length: 3), nextState: HomeState.pageChangedState(index: 0, length: 3) }
[日志] 'package:flutter/src/rendering/object.dart': 断言失败：第3345行第14位: 'renderer.parent != null': 不成立。

当前操作 #

已尝试修改package:flutter/src/rendering/object.dart文件，添加renderer && renderer.parent的非空判断，但问题未解决。

解决方案 #

1. 恢复Flutter源码：直接修改SDK源码不是合理方案，升级SDK会丢失修改，且未触及问题根源。先将修改的源码恢复到原始状态。
2. 定位触发场景：该断言通常因渲染对象已从渲染树移除后，仍被访问父节点导致。结合日志中的pageChangedState，问题大概率出在页面切换时，旧页面的渲染对象未完成销毁就被操作。
3. 检查页面切换逻辑：
   • 排查PageView或自定义页面切换代码，确认是否在页面切换时直接操作了旧页面的渲染对象。
   • 确保页面dispose后，不再持有或操作其内部渲染相关对象。
   • 使用WidgetsBinding.instance.addPostFrameCallback延迟执行相关操作，确保渲染树更新完成后再处理。
4. 排查状态管理代码：状态变化（onChange Change）触发了报错，检查状态更新时是否触发了已销毁页面组件的重建操作。比如状态更新后，旧页面组件仍在执行渲染逻辑。
5. 用调试工具定位：
   • 打开Flutter DevTools，报错时查看调用栈，找到触发问题的业务代码位置。
   • 在报错前添加断点，跟踪renderer的生命周期和来源。

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