PyQt5跨线程信号槽传递QObject派生类丢失自定义类型问题求解

根本原因 #

该问题是PyQt跨线程信号槽传递QObject子类实例时的典型对象切片问题，底层触发逻辑如下：

• 你定义的sig_add_tx_job = pyqtSignal(TxJob)默认按值传递参数，当信号槽跨线程连接时，Qt默认采用队列连接（Qt.QueuedConnection），需要先把参数序列化存入事件队列，再在接收线程反序列化后传递给槽函数。
• QObject类的拷贝构造函数是被显式禁用的，Qt元对象系统无法完成自定义QObject子类的完整拷贝，只能保留基类QObject的部分，最终就出现了类型退化、自定义属性/方法丢失的现象。
• 你之前复用该流程未出问题，是因为同线程信号槽默认用直接连接（Qt.DirectConnection），参数直接传递内存引用，不需要序列化拷贝，自然不会触发切片。

修复方案 #

共有三种可行的修复方案，按推荐度排序如下：

方案1：信号参数声明为Python通用对象类型 #

修改信号定义，用object替代具体的TxJob类型，让PyQt直接传递Python对象引用，不走Qt的元类型序列化流程，完全规避切片问题：

# 修改test_iocan.py中的信号定义
sig_add_tx_job = pyqtSignal(object)

该方案改动最小，无额外性能损失，是处理这类场景的常用方案。

方案2：注册自定义类型到Qt元对象系统 #

在TxJob类定义完成后，将其注册到Qt元类型系统，让Qt可以正确识别该自定义类型：

# 在test_tx_job.py末尾添加注册逻辑
from PyQt5.QtCore import qRegisterMetaType
qRegisterMetaType(TxJob)

该方案保留了信号参数的强类型校验，适合对类型安全要求高的场景。

方案3：显式传递对象指针 #

如果习惯C++ Qt的开发范式，可以将信号参数声明为指针类型，跨线程传递时仅拷贝指针地址，不需要拷贝对象本身：

# 修改test_iocan.py中的信号定义
sig_add_tx_job = pyqtSignal('TxJob*')

该方案需要额外注意对象生命周期管理，避免出现野指针问题。

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