You need to enable JavaScript to run this app. shared_ptr托管的QGraphicsItem添加到场景后显示异常的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

shared_ptr托管的QGraphicsItem添加到场景后显示异常的问题排查

问题根因与解决思路

核心现象梳理

  • 开发图表可视化工具时,将std::shared_ptr<DiagramItem>通过.get()获取的原始指针传入QGraphicsScene::addItem()后,对应图元无法正常渲染
  • 独立测试场景下:测试函数内通过make_shared创建的DiagramItem,调用addItem()后通过scene->items()检查,对象根本未被加入场景
  • 业务代码场景下:跨模块获取的shared_ptr管理的DiagramItem,调用addItem()后scene->items()可检索到对象,但始终不会触发paint()方法执行,完全不可见
  • 对照验证:将代码中所有智能指针替换为普通原生DiagramItem*后,所有图元渲染完全正常,但受项目架构约束无法放弃智能指针使用
  • 已完成的排查:手动对图元调用show()、update(),调整场景边界确保图元在可视范围内,在paint()方法打断点始终未命中;排查过Qt论坛同类案例,其根因为图元离开作用域被销毁,与当前业务场景不匹配

核心参考代码

class DiagramItem : public QGraphicsItem
{
    ...
}

// 初始化场景
auto scene = new QGraphicsScene(nullptr);

// 获取/创建图元
auto item1 = std::make_shared<DiagramItem>(nullptr, QString("aaa"), true);
auto item2 = GetDiagramItem(...);

// 传入原始指针添加到场景
scene->addItem(item1.get());
scene->addItem(item2.get());

// 实际运行表现:
// item1 完全未出现在scene->items()返回列表中
// item2 在列表中但不可见
auto myItem = scene->items()[0];

根因定位

首先明确一个基本事实:QGraphicsScene::addItem()本身不关心传入指针的来源是智能指针还是原生指针,不存在针对shared_ptr的特殊拦截逻辑,也没有所谓的“内存层面限制”。所有异常本质是两类开发中非常常见的使用误区,和你的现象完全匹配:

1. 多继承场景下的指针偏移错误

绝大多数自定义的DiagramItem类,都会同时多继承QObject(实现信号槽、属性绑定)和QGraphicsItem(实现图元渲染能力)。这种多继承结构下,同一个对象的不同基类子对象指针,在内存中存在固定的偏移量,编译器会在类型转换时自动调整地址值。
如果出现以下场景,就会触发异常:

  • 上层模块为了通用性,把DiagramItem类型的shared_ptr向上转型为基类(比如shared_ptr<QObject>)存储,此时如果没有通过正确的类型转换转回DiagramItem*就直接调用.get(),拿到的是QObject子对象的地址,和正确的QGraphicsItem子对象地址存在偏移差
  • 把这个偏移错误的指针强转为QGraphicsItem*传给addItem()时,Qt内部要么因为指针结构校验不通过,直接拒绝插入(对应item1完全不在列表里的现象);要么因为访问到了错误的内存地址,读取到无效的boundingRect值,导致空间索引判定图元和可视区域无交集,最终不会触发paint()调用(对应item2在列表里但不绘制的现象)

这种情况下,如果你把shared_ptr替换为原生的DiagramItem*,编译器会自动在类型转换时完成正确的地址偏移,所有逻辑立刻恢复正常,和你做对照实验的观察结果完全一致。

2. 构造失败导致的空指针传入

测试场景下item1完全不在列表的另一个可能原因:std::make_shared<DiagramItem>(nullptr, ...)构造时,传入的第一个参数nullptr触发了DiagramItem构造函数的异常分支(比如构造函数内部断言父指针非空、空指针参数校验失败抛出异常),导致make_shared构造失败、返回空的shared_ptr实例。
此时调用.get()拿到的是nullptr,Qt的addItem()接口第一逻辑就是对空指针做拦截直接返回,不会执行任何插入操作,最终表现为item完全不在场景列表中。

合规改造方案

不需要放弃shared_ptr的使用,只需要做两个小调整即可解决问题:

  • 所有存储DiagramItem的shared_ptr,模板类型必须和最派生的DiagramItem类保持一致,禁止直接以基类类型存储;如果确实需要用基类指针做类型擦除,通过std::static_pointer_cast<DiagramItem>完成类型转换后,再调用.get()传入addItem,保证拿到的指针经过正确的地址偏移计算
  • 检查DiagramItem构造函数的入参校验逻辑,保证传入nullptr父指针时不会触发异常分支,符合QGraphicsItem的常规构造规范
  • 不需要额外让QGraphicsScene接管item的内存所有权,只要保证shared_ptr在item的整个生命周期内不提前析构对象,场景内存储的item指针就始终有效

内容的提问来源于stack exchange,提问作者Dex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 12:54:03