Qt 6中如何正确继承含信号与槽的多个接口？

问题场景 #

想要定义两个包含信号和纯虚槽的接口类，再实现一个继承这两个接口的类，后续通过接口指针传递对象并连接信号槽，最终调用实现类的槽函数。原写法在Qt 5的.pro项目中可行，但在Qt 6.6.2的CMake QML项目中出现以下问题：

• 接口类触发警告：“不能使用虚拟信号”，错误：“声明信号与槽的类必须包含Q_OBJECT宏”
• 给接口类添加Q_OBJECT宏后，又要求接口类继承QObject，进而引发QObject菱形继承错误
• 尝试使用Q_DECLARE_INTERFACE和Q_INTERFACES宏无法解决基础继承问题

原接口类代码：

#include <QObject>

class Interface1
{
public:
    virtual ~Interface1(){}
signals:
    virtual void somethingHappened1() = 0;
public slots:
    virtual void doSomething1() = 0;
};

class Interface2
{
public:
    virtual ~Interface2(){}
signals:
    virtual void somethingHappened2() = 0;
public slots:
    virtual void doSomething2() = 0;
};

原实现类代码：

class Implementation : public QObject, public Interface1, public Interface2
{
    Q_OBJECT
signals:
    void somethingHappened1() override;
    void somethingHappened2() override;
public slots:
    void doSomething1() override
    {
        // implementation goes here
    }
    void doSomething2() override 
    {
        // implementation goes here
    }
};

原因说明 #

这种纯虚信号+非QObject接口的写法在Qt 6中被正式禁止。Qt 6对MOC（元对象编译器）的规则进行了严格强化：

1. 只有继承QObject的类才能使用signals:/slots:块
2. 信号不能被声明为纯虚函数，因为信号是由MOC自动生成实现代码的特殊成员函数，本身不允许用户定义纯虚版本

解决方案 #

方案1：接口仅定义行为契约，信号由实现类承载 #

接口类只声明槽的纯虚函数和触发信号的方法，将信号的声明和发射逻辑放在实现类中，避免接口依赖QObject：

#include <QObject>

// 接口1：定义槽的契约和触发信号的方法
class Interface1
{
public:
    virtual ~Interface1() = default;
    // 纯虚槽声明
    virtual void doSomething1() = 0;
    // 触发信号的接口，由实现类完成实际emit操作
    virtual void triggerSomethingHappened1() = 0;
};

// 接口2同理
class Interface2
{
public:
    virtual ~Interface2() = default;
    virtual void doSomething2() = 0;
    virtual void triggerSomethingHappened2() = 0;
};

// 实现类：继承QObject和两个接口
class Implementation : public QObject, public Interface1, public Interface2
{
    Q_OBJECT
signals:
    void somethingHappened1();
    void somethingHappened2();

public slots:
    void doSomething1() override
    {
        // 自定义实现逻辑
    }

    void doSomething2() override
    {
        // 自定义实现逻辑
    }

public:
    void triggerSomethingHappened1() override
    {
        emit somethingHappened1();
    }

    void triggerSomethingHappened2() override
    {
        emit somethingHappened2();
    }
};

使用示例：

Implementation impl;
Interface1* iface1 = &impl;
Interface2* iface2 = &impl;

// 连接信号：将接口指针转为QObject*后连接
QObject::connect(qobject_cast<QObject*>(iface1), &Implementation::somethingHappened1,
                 qobject_cast<QObject*>(iface1), &Implementation::doSomething1);

// 通过接口触发信号
iface1->triggerSomethingHappened1();

方案2：虚继承QObject解决菱形继承问题 #

如果必须让接口直接关联信号，可以让接口类虚继承QObject，避免多继承时的QObject菱形冲突：

#include <QObject>

// 接口1：虚继承QObject，添加Q_OBJECT宏
class Interface1 : public virtual QObject
{
    Q_OBJECT
public:
    virtual ~Interface1() = default;
signals:
    virtual void somethingHappened1() = 0;
public slots:
    virtual void doSomething1() = 0;
};

// 接口2：同样虚继承QObject
class Interface2 : public virtual QObject
{
    Q_OBJECT
public:
    virtual ~Interface2() = default;
signals:
    virtual void somethingHappened2() = 0;
public slots:
    virtual void doSomething2() = 0;
};

// 实现类：继承QObject和两个接口（虚继承避免菱形冲突）
class Implementation : public QObject, public Interface1, public Interface2
{
    Q_OBJECT
signals:
    void somethingHappened1() override;
    void somethingHappened2() override;

public slots:
    void doSomething1() override
    {
        // 自定义实现逻辑
    }

    void doSomething2() override
    {
        // 自定义实现逻辑
    }
};

注意：这种写法虽然能通过编译，但虚继承QObject可能在部分元对象系统场景下存在兼容性问题，优先推荐方案1。

补充说明 #

• Q_DECLARE_INTERFACE/Q_INTERFACES的作用是让Qt元对象系统识别接口类型，支持qobject_cast转换，但无法替代QObject继承来实现信号槽的元对象支持。
• Qt 6的规则变化是为了规范元对象系统的使用，避免非标准写法带来的潜在问题。

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