如何通过编程无错误关闭Qt QML应用程序？

问题现象 #

在Qt5系列版本（5.9.9、5.13.0、5.15）中，通过编程方式关闭QML应用时会出现“程序意外结束”“进程被强制终止”的错误：

• 无论在C++中直接调用QCoreApplication::quit()/QGuiApplication::quit()，还是在QML中通过Qt.callLater(Qt.quit)并关联QQmlApplicationEngine::quit信号到QGuiApplication::quit，都会触发该错误。
• 点击窗口自带的标准关闭按钮时，应用可正常退出。
• 移除QQmlApplicationEngine::load(url)后，应用编程关闭也能正常完成。
• Qt6.4及以上版本无此问题。

测试环境 #

• Qt版本：Qt5.9.9、Qt5.13.0（MinGW/MSVC2017 32/64位）、Qt5.15
• 正常版本：Qt6.4+

复现代码 #

C++代码 #

#include <QGuiApplication>
#include <QTimer>
#include <QQmlApplicationEngine>
int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    const QUrl url(QStringLiteral("qrc:/main.qml"));
    engine.load(url);

    QTimer* timer=new QTimer();
    QObject::connect(timer, &QTimer::timeout, &app, &QGuiApplication::quit, Qt::QueuedConnection);
    timer->start(2000);

    return app.exec();
}

QML代码 #

import QtQuick 2.12
import QtQuick.Window 2.12

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")
}

原因分析 #

Qt5中QQmlApplicationEngine的资源清理逻辑存在时序问题：当直接调用QGuiApplication::quit()终止事件循环时，引擎内部的QML对象可能仍在异步销毁或释放资源，此时进程提前结束会引发资源访问冲突，导致异常终止。而通过窗口关闭按钮触发退出时，会先完成QML窗口的销毁流程，再进入应用退出逻辑，避免了该冲突。

解决方案 #

1. 先销毁QML窗口再退出应用 #

获取QML根窗口对象，先触发窗口关闭，确保QML资源完成清理后再终止应用：

// 在engine.load(url)之后添加
QObject *rootObject = engine.rootObjects().first();
QWindow *mainWindow = qobject_cast<QWindow*>(rootObject);

// 修改定时器的槽函数
QObject::connect(timer, &QTimer::timeout, [mainWindow, &app](){
    mainWindow->close();
    // 延迟触发quit，确保窗口销毁完成
    QTimer::singleShot(100, &app, &QGuiApplication::quit);
}, Qt::QueuedConnection);

2. 手动清理引擎资源 #

在退出前先清理QQmlApplicationEngine的资源，再延迟终止应用：

QObject::connect(timer, &QTimer::timeout, [&engine, &app](){
    engine.clearComponentCache();
    engine.deleteLater();
    QTimer::singleShot(50, &app, &QGuiApplication::quit);
}, Qt::QueuedConnection);

3. 替换为QQuickView #

Qt5中QQuickView的退出逻辑更稳定，替换QQmlApplicationEngine后可避免异常：

#include <QGuiApplication>
#include <QTimer>
#include <QQuickView>
int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQuickView view;
    view.setSource(QUrl(QStringLiteral("qrc:/main.qml")));
    view.show();

    QTimer* timer=new QTimer();
    QObject::connect(timer, &QTimer::timeout, &app, &QGuiApplication::quit, Qt::QueuedConnection);
    timer->start(2000);

    return app.exec();
}

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