Qt6.5.4 macOS下模态对话框无父窗口报错解决方案咨询

问题原因 #

这个报错的核心是窗口模态对话框必须绑定一个父窗口。macOS的窗口管理机制对模态窗口的父级关联要求严格，你的MessageDialog默认是窗口模态（modal: true），但未指定父窗口，导致Qt无法正确处理其模态行为。

解决办法 #

方法1：为MessageDialog指定父窗口（推荐）

Qt要求模态对话框必须依附于一个父窗口，以下两种方式都能解决问题：

方案1a：改用ApplicationWindow作为根元素（规范做法）

将QML的根元素从Item改为ApplicationWindow，明确窗口上下文，并将对话框绑定到窗口：

import QtQuick
import QtQuick.Dialogs
import QtQuick.Window

ApplicationWindow
{
    width: 640
    height: 480
    visible: true

    MessageDialog
    {
        id: testDialog
        title: "Test"
        text: "For test purposes"
        parent: window // 绑定到当前窗口
    }

    Rectangle
    {
        anchors.centerIn: parent
        width: parent.width / 2
        height: parent.height / 2
        color: "red"

        MouseArea
        {
            anchors.fill: parent
            onClicked: testDialog.open()
        }
    }
}

同时修改main.cpp，使用QQmlApplicationEngine加载窗口：

#include <QtCore>
#include <QtWidgets>
#include <QtQuick>
#include <QtQuickControls2>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl("qrc:/SimpleScreen.qml"));
    return a.exec();
}

方案1b：在现有Item结构下绑定父窗口

如果不想修改C++代码和根元素结构，可以通过Qt.application.activeWindow()获取当前激活窗口作为对话框的父级：

MessageDialog
{
    id: testDialog
    title: "Test"
    text: "For test purposes"
    parent: Qt.application.activeWindow().contentItem
}

方法2：设置对话框为非模态（仅适用于不需要阻塞操作的场景）

如果业务上不需要对话框阻塞主窗口操作，可以将modal设为false，此时无需父窗口：

MessageDialog
{
    id: testDialog
    title: "Test"
    text: "For test purposes"
    modal: false
}

注意：这种方式会让用户同时操作主窗口，不推荐用于需要用户优先处理的提示场景。

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