QtCreator运行PySide6项目报错：'Constant'对象无'id'属性

问题根源 #

直接向QML传递**原生Python字典（尤其是包含自定义对象）**作为Property时，QtCreator的运行/预览环境会尝试将其序列化为JSON格式，但Qt的序列化器无法处理Python自定义对象，同时原生Python字典的格式和JSON不完全兼容，从而触发AttributeError（无法识别自定义对象的属性）和JSONDecodeError（字典序列化失败）。而直接运行或PyCharm环境中，Python-Qt桥接是直接传递对象引用，不会触发JSON序列化，因此可以正常运行。

解决方案 #

1. 替换原生字典为Qt兼容类型 #

使用PySide6提供的QVariantMap（与Pythondict兼容，但被Qt引擎原生支持）来传递映射类型数据，避免原生字典的序列化问题。

2. 转换自定义对象为基础类型 #

如果字典中包含自定义类实例，需要先将其转换为Qt序列化器能识别的基础类型（如字符串、数字、普通字典），比如给自定义类添加转换方法，提取所需属性。

3. 明确声明Property类型 #

在Python类的Property装饰器中，指定返回类型为QVariantMap，而不是泛型的dict，帮助Qt引擎正确识别数据类型。

修正后的最小示例 #

假设原代码存在自定义对象传递问题，修正后的代码如下：

from PySide6.QtCore import QObject, Property, QVariantMap
from PySide6.QtGui import QGuiApplication
from PySide6.QtQml import QQmlApplicationEngine

class Constant:
    def __init__(self, item_id):
        self.item_id = item_id  # 注意属性名避免与Qt内部关键字冲突

    # 添加转换方法，将自定义对象转为普通字典
    def serialize(self):
        return {"id": self.item_id}

class Backend(QObject):
    def __init__(self):
        super().__init__()
        # 先序列化自定义对象，再存入QVariantMap兼容的字典
        self._data = {"const": Constant(1).serialize()}

    # 明确声明Property类型为QVariantMap
    @Property(QVariantMap)
    def data(self):
        return self._data

if __name__ == "__main__":
    app = QGuiApplication([])
    engine = QQmlApplicationEngine()
    backend = Backend()
    engine.rootContext().setContextProperty("backend", backend)
    engine.load("main.qml")
    app.exec()

对应的QML示例（main.qml）：

import QtQuick 2.15
import QtQuick.Window 2.15

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Test")

    Text {
        text: backend.data.const.id
        anchors.centerIn: parent
    }
}

验证步骤 #

1. 将修正后的代码导入QtCreator，配置正确的PySide6环境
2. 运行项目，检查是否不再出现AttributeError和JSONDecodeError
3. 确认QML界面能正常显示自定义对象的属性值

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