在QMdiArea中调用QML函数时崩溃的问题排查

崩溃的核心原因是你在初始化QmlWindow时，将quickWidget->rootObject()的值拷贝捕获到了lambda中。当窗口被加入QMdiArea后，QMdiArea的窗口管理逻辑（比如子窗口的显示、布局调整、窗口状态变化）可能触发QQuickWidget内部的QML对象树重建，或者导致原rootObject的内存地址失效/被复用，此时lambda中保存的旧指针不再指向正确的QML根对象（甚至可能指向了Map控件自带的QQuickPinchHandler对象，这就是错误提示的来源）。

虽然初始化时调试显示rootObject有效且存在plusBtn方法，但QMdiArea的环境变化会让这个旧指针变成野指针或指向错误对象，最终导致调用invokeMethod时崩溃或提示方法不存在。

解决思路是避免保存rootObject的静态指针，而是在每次需要调用QML方法时实时获取当前有效的rootObject；或者改用信号槽绑定的方式，让Qt自动管理对象生命周期。

方案1：实时获取rootObject #

修改QmlWindow中按钮的连接逻辑，每次点击时重新获取rootObject，而非使用初始化时的旧指针：

connect(button, &QPushButton::pressed, this, [this]() {  // 捕获this而非rootObj
    QQuickItem* rootObj = quickWidget->rootObject();
    if (!rootObj) {
        qWarning() << "Root object is null!";
        return;
    }
    // 可选：校验对象类型，避免指向错误对象
    if (QString(rootObj->metaObject()->className()) != "Map_QMLTYPE_0") {
        qWarning() << "Root object type mismatch!";
        return;
    }
    QMetaObject::invokeMethod(rootObj, "plusBtn");
});

方案2：使用信号槽绑定（更安全） #

在QML中定义信号，点击C++按钮时触发该信号，QML中响应信号调用plusBtn。这种方式由Qt对象树机制自动管理，不会出现指针失效问题：

修改QML（Map.qml） #

在根Rectangle中添加信号并绑定到方法：

Rectangle {
    id: rectangle
    signal triggerPlusBtn()  // 新增信号

    // ... 原有代码 ...

    function plusBtn() {
        // ... 原有逻辑 ...
    }

    // 绑定信号到方法
    onTriggerPlusBtn: plusBtn()
}

修改C++（QmlWindow） #

每次点击时触发QML信号：

connect(button, &QPushButton::pressed, this, [this]() {
    QQuickItem* rootObj = quickWidget->rootObject();
    if (!rootObj) {
        qWarning() << "Root object is null!";
        return;
    }
    QMetaObject::invokeMethod(rootObj, "triggerPlusBtn");
});

额外优化建议 #

• 给QML根对象设置objectName，通过findChild精准获取对象，避免类型匹配问题：

  Rectangle {
      id: rectangle
      objectName: "rootMapRect"
      // ... 其他代码 ...
  }
  

  C++中获取：

  QQuickItem* rootObj = quickWidget->rootObject()->findChild<QQuickItem*>("rootMapRect");
  

• 确保QQuickWidget::setResizeMode设置为SizeRootObjectToView，避免窗口大小变化导致QML对象频繁重建。

内容的提问来源于stack exchange，提问作者i.troyen