PyQt5 QAbstractItemModel实现树形模型时崩溃问题排查

1. 死磕index()方法的索引创建逻辑 #

• 必须先判断父索引有效性：父索引无效（parent.isValid()为False）时才处理根节点；父索引有效时，要确认对应的实体确实存在，别瞎访问不存在的对象搞出内存越界。
• 索引创建参数不能瞎传：QModelIndex(self, row, column, parent_entity)里的parent_entity得是模型持有的有效实体对象，不能传None或者已经被销毁的临时对象（比如查完数据库没存的对象）。
• 越界请求直接返回空索引：如果请求的row/column超出当前父节点的范围，必须返回QModelIndex()，别硬造索引。

2. 严格校验parent()方法的返回逻辑 #

• 根节点索引必须返回空索引：只要index.internalPointer()是根实体或者None，直接返回QModelIndex()，别搞其他无效索引。
• 非根节点要准确返回父索引：得确保父实体的索引是用createIndex()创建的有效索引，而且父实体确实在模型里，别返回指向已释放内存的索引。
• 杜绝循环引用：比如父索引指向子节点，让模型遍历陷入死循环，最后内存炸了崩溃。

3. 基础模型方法的边界不能乱 #

• rowCount()：父索引无效时返回根节点数；父索引对应的实体不存在，直接返回0，别搞负数或者随机数。
• columnCount()：尽量保证所有节点返回的列数一致，别根节点和子节点列数不一样，容易搞崩视图渲染。

4. 管好实体的内存生命周期 #

• 所有数据库实体必须被模型强引用（比如存在模型内部的列表、字典里），不能让Python把实体垃圾回收了，否则internalPointer()访问的是已经释放的内存，直接触发0xC0000005错误。
• 别在模型方法里临时造实体就扔：比如在index()里临时查数据库拿实体，没存到模型缓存里，方法结束实体就被回收了，后续视图访问索引必崩。

5. 无回溯时的调试技巧 #

• 给index()和parent()加日志：打印请求的row/column、父索引状态、返回的索引信息，找到崩溃前最后执行的步骤。
• 先搞硬编码测试：写个固定的树形结构（比如根节点+2个子节点），验证模型能跑起来，再逐步换成数据库逻辑，排查是数据还是模型方法的问题。
• 先禁用自定义委托：用默认委托测模型是否正常，排除委托代码搞出来的崩溃。

内容的提问来源于stack exchange，提问作者h-c