PyQt6项目中WebSocket触发加载QML文件时内存泄漏崩溃求助

针对你遇到的WebSocket事件触发QML加载崩溃问题（错误码0xC0000409），结合Qt/PyQt的特性，按以下方向排查：

• 线程安全验证
  WebSocket的消息回调几乎都是在子线程执行的，而Qt的QML引擎（QQmlApplicationEngine）属于UI线程对象，必须在主线程中调用其方法。跨线程直接操作会导致内存损坏或栈溢出。
  排查步骤：

  1. 在WebSocket的加载代码前添加线程检查：

     from PyQt5.QtCore import QThread, QGuiApplication
     print(QThread.currentThread() == QGuiApplication.instance().thread())
     

  2. 如果输出False，则通过QMetaObject.invokeMethod将加载操作转到主线程：

     from PyQt5.QtCore import QMetaObject, Qt
     # 在WebSocket事件回调中
     def on_websocket_trigger(self):
         QMetaObject.invokeMethod(
             self.engine, 
             "load", 
             Qt.QueuedConnection,
             Qt.Q_ARG(str, "anotherqml.qml")
         )
     

• 对象生命周期与引用检查
  确认WebSocket类中持有engine的强引用，避免Python垃圾回收器误回收engine实例：

  1. 检查WebSocket类的初始化代码，确保self.engine = engine是直接赋值（而非弱引用）；
  2. 加载前后打印id(self.engine)，确认实例未被替换或回收；
  3. 加载新QML前，清理旧的根窗口对象，避免内存堆积：

     for root_obj in self.engine.rootObjects():
         root_obj.deleteLater()
     self.engine.load("anotherqml.qml")
     

• QML文件兼容性排查
  虽然直接加载正常，但WebSocket触发场景下可能存在上下文依赖问题：

  1. 临时替换为极简QML文件测试（如下），看是否仍崩溃：

     import QtQuick 2.15
     import QtQuick.Window 2.15
     
     Window {
         visible: true
         width: 400
         height: 300
         Text { text: "Test Window" }
     }
     

  2. 如果不崩溃，逐步添加原QML的组件，定位到引发问题的代码块。

• Qt调试日志分析
  启用Qt的调试输出，捕获加载过程中的潜在错误：

  1. 在main.py开头添加日志处理函数：

     from PyQt5.QtCore import qInstallMessageHandler, QtMsgType
     
     def qt_debug_handler(msg_type, context, msg):
         msg_type_str = {
             QtMsgType.QtDebugMsg: "DEBUG",
             QtMsgType.QtWarningMsg: "WARNING",
             QtMsgType.QtCriticalMsg: "CRITICAL",
             QtMsgType.QtFatalMsg: "FATAL"
         }.get(msg_type, "UNKNOWN")
         print(f"[{msg_type_str}] {msg}")
     
     qInstallMessageHandler(qt_debug_handler)
     

  2. 运行程序，查看加载QML时的日志输出，重点关注CRITICAL/FATAL级别的错误。

• 版本与环境验证
  旧版本PyQt可能存在线程与QML交互的bug：

  1. 升级PyQt5/PySide2到最新稳定版；
  2. 尝试切换到PySide6测试，看问题是否复现。

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