PyQt自定义QPolygon被删除：RuntimeError问题排查求助

可能的原因分析 #

• Qt父子对象自动销毁机制：这是最容易踩的坑。当你把ImagePolygon添加到QGraphicsScene时，场景会自动成为它的父对象。一旦旧场景被销毁（比如切换场景时覆盖了旧场景的引用，Python垃圾回收触发回收），Qt会递归销毁所有子对象——包括你的ImagePolygon底层C实例。哪怕Python层面还保留着这个对象的引用，底层C对象已经没了，再访问自然会抛出那个RuntimeError。
• Python与Qt生命周期不匹配：Python的垃圾回收和Qt的对象管理是两套独立体系。比如你移除ImagePolygon后没保留强引用，Python GC把包装器回收了，但Qt还在尝试访问；或者反过来，Qt已经销毁了C++对象，但Python的包装器还存在，这时候调用任何方法都会报错。
• 场景操作的逻辑漏洞：比如重复将同一个ImagePolygon添加到多个场景，或者移除时没正确调用scene.removeItem()，导致Qt的对象管理混乱，触发意外销毁。哪怕你后来重新设置了QPolygon，只要底层C++对象已经被删，就没用了。

实用调试方法 #

• 监听对象销毁时机：给你的ImagePolygon绑定destroyed信号，一旦底层C++对象被销毁就触发日志，精准定位销毁发生的时间点：

  self.image_polygon.destroyed.connect(lambda obj: print(f"⚠️ ImagePolygon {obj} destroyed!"))
  

  结合场景创建、切换的日志，就能知道是不是旧场景销毁时带掉了多边形对象。
• 强制脱离场景的自动管理：如果需要保留ImagePolygon的生命周期不受场景影响，创建时给它指定一个固定的父对象（比如主窗口），而不是让场景成为父对象：

  self.image_polygon = ImagePolygon(parent=self.main_window)
  

  这样即使旧场景被销毁，多边形对象也不会被Qt自动删除，你可以安全复用。
• 启用Qt调试日志：在程序启动时开启Qt的调试输出，跟踪场景和多边形对象的创建、销毁流程：

  from PyQt5.QtCore import qInstallMessageHandler, QtDebugMsg
  
  def debug_handler(msg_type, context, msg):
      if msg_type == QtDebugMsg:
          print(f"Qt Debug: {msg.data().decode()}")
  
  qInstallMessageHandler(debug_handler)
  

  这样能看到Qt内部关于对象销毁的详细日志，帮你找到触发销毁的操作。
• 逐段排查新增代码：既然是新增功能后出现的问题，把新增的代码块逐段注释掉，每注释一块就测试一次，直到问题消失——那这段代码就是罪魁祸首。重点检查场景切换、多边形对象的复用/修改逻辑。
• 检查引用情况：用Python的gc模块确认你的ImagePolygon确实还被引用着：

  import gc
  referrers = gc.get_referrers(self.image_polygon)
  print(f"Referrers for ImagePolygon: {referrers}")
  

  如果输出里没有你预期的引用，说明某个地方悄悄把引用丢了，导致Python GC回收了包装器，进而触发Qt对象销毁。

内容的提问来源于stack exchange，提问作者Miguel Kulisic