无GUI模块的Qt程序通过QLibrary加载含QWidget的DLL调用崩溃问题

我编写了一个用于显示单个QWidget的DLL，相关代码如下：

testqtlib.h #

#pragma once

#include <QtCore/qglobal.h>

#if defined(TESTQTLIB_LIBRARY)
#  define TESTQTLIB_EXPORT Q_DECL_EXPORT
#else
#  define TESTQTLIB_EXPORT Q_DECL_IMPORT
#endif

extern "C" TESTQTLIB_EXPORT void createWidget();

testqtlib.cpp #

#include <QtWidgets>
#include "testqtlib.h"

void createWidget() {
    auto widget = new QWidget;
    widget->resize(100, 100);
    widget->move(0, 0);
    widget->show();
}

我尝试在一个未在.pro文件中添加gui和widgets模块的Qt程序中调用createWidget()函数，调用代码如下：

QLibrary library("testQtLib.dll");
library.load();
typedef void (*testWidget)(void);
auto crW = (testWidget)library.resolve("createWidget");
if (crW) {
  debugFile << __func__ << "crW OK:" << std::endl;
  crW();
} else
  debugFile << __func__ << "crW empty" << std::endl;

debugFile显示crW不为空，但调用crW()时程序崩溃。系统路径中已存在Qt5Gui.dll和Qt5Widgets.dll，而如果在.pro文件中添加了gui和widgets模块的程序中执行相同调用，则一切正常。请问崩溃原因是什么？是否需要加载Qt5Gui.dll和Qt5Widgets.dll，或有其他解决方案？

崩溃核心原因 #

崩溃本质是Qt GUI模块未完成初始化：

• 当主程序.pro未声明gui和widgets模块时，Qt初始化流程仅启动core模块，不会创建GUI所需的全局上下文（比如QGuiApplication实例、窗口系统交互环境、控件渲染基础资源等）。
• 虽然系统路径存在Qt5Gui.dll和Qt5Widgets.dll，但主程序未触发这些模块的初始化逻辑。DLL中创建QWidget时，依赖的GUI底层资源不存在，直接触发内存访问错误或未定义行为，导致崩溃。

可行解决方案 #

方案1：主程序显式初始化GUI模块 #

即使主程序本身不需要GUI界面，也需要初始化QApplication（或QGuiApplication），确保GUI模块完成初始化。同时主程序.pro需添加QT += gui widgets：

#include <QApplication>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QLibrary library("testQtLib.dll");
    if (library.load()) {
        typedef void (*testWidget)(void);
        auto crW = (testWidget)library.resolve("createWidget");
        if (crW) {
            crW();
        }
    }

    return app.exec();
}

方案2：DLL内部负责GUI初始化 #

修改DLL代码，在创建QWidget前检查并初始化GUI模块，避免依赖主程序配置：

#include <QtWidgets>
#include "testqtlib.h"

void createWidget() {
    // 检查是否已有GUI应用实例，无则创建
    if (!QGuiApplication::instance()) {
        int argc = 0;
        char* argv[] = {nullptr};
        new QApplication(argc, argv);
    }

    auto widget = new QWidget;
    widget->resize(100, 100);
    widget->move(0, 0);
    widget->show();

    // 若需窗口持续显示，可启动事件循环，但需注意主程序已有事件循环的冲突问题
    // QApplication::instance()->exec();
}

方案3：主程序手动加载GUI DLL并初始化 #

若不想修改.pro，可手动加载GUI相关DLL后初始化QApplication：

#include <QLibrary>
#include <QApplication>

int main(int argc, char *argv[]) {
    // 手动加载Qt GUI相关动态库
    QLibrary qtGuiDll("Qt5Gui.dll");
    QLibrary qtWidgetsDll("Qt5Widgets.dll");
    
    if (qtGuiDll.load() && qtWidgetsDll.load()) {
        QApplication app(argc, argv);

        QLibrary library("testQtLib.dll");
        if (library.load()) {
            typedef void (*testWidget)(void);
            auto crW = (testWidget)library.resolve("createWidget");
            if (crW) {
                crW();
            }
        }

        return app.exec();
    }
    return 1;
}

内容的提问来源于stack exchange，提问作者Borys L.