Qt5.15.2传递QAbstractItemModel*至C++类报错，Qt6正常原因排查

问题根源 #

Qt5的元对象系统与QML类型映射机制对const修饰的QObject派生类指针支持存在局限，无法正确识别const QAbstractItemModel*作为合法的QML可调用方法参数类型。而Qt6重构了元类型处理逻辑，完善了对const修饰指针的类型识别，因此在Qt6环境下代码可以正常运行。

解决方案 #

方案1：移除参数的const修饰（推荐） #

直接将方法参数改为QAbstractItemModel*，Qt5的QML类型系统可以正确识别该类型，且只要你在方法内部不修改模型对象，依然能保持逻辑上的const语义。

修改后的Utility类示例：

class Utility : public QObject
{
    Q_OBJECT
public:
    explicit Utility(QObject *parent = nullptr) : QObject(parent) {}

    Q_INVOKABLE void test(QAbstractItemModel* model) {
        // 内部仅读取模型数据，不修改，保持const语义
        if (model) {
            qDebug() << "模型行数：" << model->rowCount();
        }
    }
};

方案2：注册const修饰的元类型 #

如果业务逻辑必须保留const关键字，可以在注册单例前手动注册对应的元类型：

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    // 注册const QAbstractItemModel*元类型
    qRegisterMetaType<const QAbstractItemModel*>("const QAbstractItemModel*");

    Utility utility;
    qmlRegisterSingletonInstance<Utility>("com.example", 1, 0, "Utility", &utility);

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));

    return app.exec();
}

注意：部分Qt5版本中，即使注册了该元类型，仍可能存在兼容性问题，因此方案1是更稳妥的选择。

额外说明 #

Qt6对元类型系统做了大量优化，包括对const修饰的指针、引用类型的自动识别，因此无需额外处理即可支持const QAbstractItemModel*这类参数。

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