QML中通过Session对象传递QList<QObject*>作为ListView模型失败排查

我尝试按照Qt官方文档《Using C++ Models with Qt Quick Views》的方法，将QList<QObject*>类型的实例作为QML ListView的模型使用。直接照搬官方示例代码可以正常运行，但通过上下文绑定的自定义Session对象获取模型时遇到了问题。

Session类核心代码 #

class Session : public QObject
{
    Q_OBJECT

    typedef QVariant result_type;

    Q_PROPERTY(result_type items READ items NOTIFY itemsChanged)
    // 其他未展示代码...
};

其中items的每个元素都是带有name属性的DataObject实例。

对应QML代码 #

ListView {
    model: session.items

    delegate: Rectangle {
        required property string name
    }
}

主函数相关代码 #

Session session;

QQmlContext* context = engine.rootContext();
context->setContextProperty("session", &session);

// 其他初始化逻辑...

QList<QObject*> dataList;
session.setItems(dataList);

问题现象 #

已确认session.items包含有效数据，且Session对象在其他QML场景中能正常使用，但运行时始终报错：

Required property was not initialized

临时解决方法：通过modelData.name可以访问到属性，但想明确问题的根源。

问题根源 #

问题出在Session类的items属性类型上：用QVariant包装QList<QObject*>后，QML无法自动识别这是一个基于QObject的列表模型，只能将其视为普通的Variant列表处理。

官方示例中直接暴露QList<QObject*>时，Qt元对象系统会自动将其识别为QObjectListModel，ListView能直接解析每个元素的属性（如name）。但经QVariant包装后，QML无法完成这个类型转换，导致delegate里的required property string name找不到对应数据源，只能通过modelData访问整个元素对象再取属性。

修复方案 #

修改Session类的items属性类型，直接使用QList<QObject*>而非QVariant：

class Session : public QObject
{
    Q_OBJECT

    Q_PROPERTY(QList<QObject*> items READ items NOTIFY itemsChanged)
    
    // 确保getter返回正确类型
    QList<QObject*> items() const;
    // 其他代码保持不变...
};

修改后QML能正确识别列表模型，delegate里的required property string name会自动绑定到每个DataObject的name属性，无需再依赖modelData。

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