使用QQmlOpenMetaObject后类方法重载失效，求解决方案？

问题原因 #

QQmlOpenMetaObject作为Qt私有API，默认实现会替换目标类的元对象，且未合并原有类的静态元方法（比如Q_INVOKABLE修饰的重载方法）。这导致QML引擎只能识别OpenMetaObject中维护的动态方法，无法正确解析原有类的重载方法签名，从而出现无参方法调用时参数不足的报错。

解决方案 #

自定义QQmlOpenMetaObject子类，手动合并原有类的静态元方法与动态元对象的方法，让QML引擎能正确识别所有重载方法。

步骤1：自定义OpenMetaObject子类 #

重写methodCount()和method()方法，将原有类的元方法纳入元对象体系：

#include <QQmlOpenMetaObject>
#include <QMetaMethod>
#include <QJSValue>

class MyOpenMetaObject : public QQmlOpenMetaObject
{
public:
    explicit MyOpenMetaObject(QObject *obj) : QQmlOpenMetaObject(obj) {}

    int methodCount() const override {
        // 合并原有类方法数与动态方法数
        return originalObject()->metaObject()->methodCount() + QQmlOpenMetaObject::methodCount();
    }

    const QMetaMethod method(int index) const override {
        const QMetaObject *originalMeta = originalObject()->metaObject();
        if (index < originalMeta->methodCount()) {
            // 返回原有类的静态方法
            return originalMeta->method(index);
        }
        // 返回动态方法，偏移原有方法索引
        return QQmlOpenMetaObject::method(index - originalMeta->methodCount());
    }
};

步骤2：在目标类中使用自定义子类 #

替换默认的QQmlOpenMetaObject实例化，改用自定义子类：

#include <QObject>
#include <QDebug>

class MyClassWithRegularMetaObject : public QObject
{
    Q_OBJECT
public:
    explicit MyClassWithRegularMetaObject(QObject *parent = nullptr) : QObject(parent) {
        // 实例化自定义OpenMetaObject
        new MyOpenMetaObject(this);
    }

    Q_INVOKABLE void fire() {
        qDebug() << "Fire without arguments";
    }

    Q_INVOKABLE void fire(const QJSValue &value) {
        qDebug() << "Fire with value:" << value.toString();
    }
};

注意事项 #

• 需在项目.pro文件中添加QT += qml-private以引入私有API头文件；
• 私有API存在版本兼容性风险，不同Qt版本可能需要调整实现细节；
• 若后续需添加动态属性/方法，自定义子类仍能正常处理原有逻辑。

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