Qt Quick2嵌入QWidget关闭主窗口触发External WM_DESTROY警告如何解决

警告触发根因 #

原实现采用的QWindow::fromWinId()包装QWidget原生窗口的方式存在两个本质问题：

• QWindow::fromWinId()的设计定位是包装非Qt体系创建的外部系统窗口，不适用于包装Qt自身创建的QWidget窗口。这种方式会让Qt对同一个原生窗口句柄维护两套独立的所有权管理逻辑，出现状态不同步。
• 资源销毁顺序不受控：主窗口关闭流程中，操作系统会优先向子窗口句柄发送WM_DESTROY消息，此时Qt内部对应的QWidgetWindow父指针已经被主窗口析构流程置空，就会抛出External WM_DESTROY received for QWidgetWindow(0x202b3a4ffe0, name="QWidgetClassWindow") , parent: QWindow(0x0) , transient parent: QWindow(0x0) 的警告。

修正方案 #

• 替换非官方的窗口包装逻辑，改用Qt原生提供的QWidget::createWindowContainer()接口完成QWidget到QQuickWindow体系的嵌入转换，从根源上解决所有权状态不同步的问题
• 严格按照从子到父的顺序管理资源生命周期，在QQuickItem析构阶段主动释放所有关联窗口资源，避免依赖Qt默认析构顺序导致的悬空指针问题
• 移除嵌入流程中不必要的独立窗口标志（如Qt::FramelessWindowHint），避免容器嵌入时的窗口属性冲突

修正后的实现代码 #

原QML代码无需改动，C++侧调整如下：

#pragma once
#include <QQuickItem>
#include <QWindow>
#include <QWidget> // createWindowContainer为QWidget静态成员，包含此头文件即可

class QWidgetWrapper : public QQuickItem
{
    Q_OBJECT
    
public:
    QWidgetWrapper(QQuickItem *parent = nullptr) : QQuickItem(parent) {}
    
    ~QWidgetWrapper() {
        // 严格按从子到父的顺序释放资源，杜绝销毁乱序
        if (m_widgetWindow) {
            m_widgetWindow->setParent(static_cast<QWindow*>(nullptr));
            delete m_widgetWindow;
            m_widgetWindow = nullptr;
        }
        if (m_widget) {
            m_widget->close();
            delete m_widget;
            m_widget = nullptr;
        }
    }

    Q_INVOKABLE void initialize(QWindow *window) {
        // 初始化目标QWidget，无需额外设置独立窗口属性
        m_widget = new QWidget();
        // 用官方容器接口生成可嵌入的QWindow对象，替代原fromWinId的自定义实现
        m_widgetWindow = QWidget::createWindowContainer(m_widget, window);
        // 同步QQuickItem尺寸到嵌入窗口，避免位置错位
        connect(this, &QQuickItem::widthChanged, this, [=](){
            if (m_widgetWindow) m_widgetWindow->setWidth(this->width());
        });
        connect(this, &QQuickItem::heightChanged, this, [=](){
            if (m_widgetWindow) m_widgetWindow->setHeight(this->height());
        });
        m_widgetWindow->show();
    }

private:
    QWidget *m_widget = nullptr;
    QWindow *m_widgetWindow = nullptr;
};

注意事项 #

• createWindowContainer生成的容器窗口，会被Qt自动纳入主窗口的父子窗口管理链，主窗口关闭时会按正确顺序遍历子窗口发送销毁指令，不会再触发乱序系统消息警告
• 如果因历史包袱必须保留原fromWinId的实现，至少需要在析构函数中显式调用m_widget->hide()、清空父子关联，再手动释放QWidget资源——但这种方式仅为临时补丁，长期稳定性不如官方容器实现
• Windows平台下如果存在偶发警告，可在主窗口的closeEvent中提前触发嵌入组件的资源释放流程，在主窗口收到系统WM_CLOSE消息、还未分发到子窗口消息队列时完成QWidget资源回收

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