QML/QT独立应用无法运行：部署后组件加载失败求助

问题概述 #

开发的QML应用在Visual Studio 2019中编译运行正常，但部署到无VS的系统（已携带QT/QML DLL）时，抛出QMLApplicationEngine failed to load component错误，提示多个QtQuick相关模块未安装，同时伴随信号槽空连接错误（因QML组件未加载导致对象为null）。

相关代码片段：

QQmlApplicationEngine engine;
const QUrl url(QStringLiteral("qrc:/main.qml"));
QObject::connect(&engine, &QQmlApplicationEngine::objectCreated, &app, [url](QObject* obj, const QUrl& objUrl)
    {
        if (!obj && url == objUrl)
        QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
engine.load(url);

错误信息示例：

QMLApplicationEngine failed to load component
qrc:/main.qml:14 module "QtQuick.Controls" is not installed
qrc:/main.qml:12 module "QtQuick.Layouts" is not installed
qrc:/main.qml:1 module "QtQuick" is not installed
qrc:/main.qml:17 module "QtQuick.Controls.Styles" is not installed
qrc:/main.qml:6 module "QtQuick.Controls.Styles" is not installed
qrc:/main.qml:4 module "QtQuick.Dialogs" is not installed

QObject::connect: Cannot connect (null)::mSegCTBone() to QMLManager::QSegCTBone()
QObject::connect: Cannot connect (null)::mSegCTLung() to QMLManager::QSegCTLung()
QObject::connect: Cannot connect (null)::mLength2D() to QMLManager::QLength2D()
QObject::connect: Cannot connect (null)::mAngle2D() to QMLManager::QAngle2D()
QObject::connect: Cannot connect (null)::mCircle2D() to QMLManager::QCircle2D()
QObject::connect: Cannot connect QMLManager::signalToEnableWaitBox() to (null)::mEnableWaitBox()

核心原因 #

QML模块的依赖不仅包含DLL文件，还需要对应的QML资源文件和模块定义文件（qmldir），手动复制DLL会遗漏这些关键文件，导致QML引擎无法识别模块。

解决步骤 #

1. 使用Qt官方工具windeployqt自动部署 #

这是最可靠的方式，能自动收集所有依赖（DLL、QML模块、平台插件等）：

• 打开对应版本的Qt命令提示符（如Qt 5.15.2 MSVC2019 64-bit）
• 切换到生成的EXE所在目录
• 执行命令：

  windeployqt --qmldir <你的QML源文件根目录> <你的应用程序.exe>
  

  示例：

  windeployqt --qmldir C:\Projects\MyQmlApp\qml MyQmlApp.exe
  

  注：--qmldir参数用于指定项目中QML文件的根目录，工具会扫描该目录下用到的所有QML模块并自动复制相关文件。

2. 验证部署后的目录结构 #

执行完windeployqt后，检查部署目录应包含以下内容：

• 根目录：Qt核心DLL（如Qt5Core.dll、Qt5Gui.dll、Qt5Qml.dll、Qt5Quick.dll等）
• 子文件夹：QtQuick、QtQuick.Controls、QtQuick.Layouts、QtQuick.Dialogs、QtQuick.Controls.Styles，每个文件夹内必须有qmldir文件及对应的QML资源/插件
• 平台插件文件夹：platforms，内含qwindows.dll等平台相关插件

3. 确认QML模块版本匹配 #

确保部署时使用的Qt版本与编译时完全一致（包括编译器架构，如32位/64位、MSVC版本），版本不匹配会导致模块加载失败。

4. 信号槽空连接问题的处理 #

这类错误是QML组件加载失败的连锁反应，当QML引擎成功加载所有模块后，对应的QML对象会正常初始化，信号槽连接问题会自动消失，无需单独处理。

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