如何在卸载依赖Qt的DLL时完全卸载所有Qt DLL并支持重复加载？

Qt核心模块（如QtCore、QtGui）采用进程全局状态设计，没有官方提供的"完全重置进程内Qt状态"API，这一设计决策至今（Qt 5/6）未发生本质变化。针对你遇到的三个核心问题，可通过以下方式处理：

一、重置Qt主线程标记 #

Qt会将首次创建QCoreApplication的线程标记为全局主线程，且该标记不会随线程销毁自动清除。需通过Qt私有API修改内部状态：

Qt 5 实现 #

#include <QtCore/private/qcoreapplication_p.h>

void resetQtMainThread() {
    if (!qApp) return;
    
    QCoreApplicationPrivate *coreD = QCoreApplicationPrivate::get(qApp);
    // 清空主线程关联
    coreD->threadData->thread = nullptr;
    coreD->threadData->quitNow = false;

    // 针对QApplication额外清理GUI线程标记
    if (auto app = qobject_cast<QApplication*>(qApp)) {
        QApplicationPrivate *appD = static_cast<QApplicationPrivate*>(coreD);
        appD->threadData = nullptr;
    }

    // 清理Qt内部线程局部存储
    QThreadStorage<void*>::destroy();
}

Qt 6 实现 #

Qt 6内部结构调整，需修改为：

#include <QtCore/private/qcoreapplication_p.h>

void resetQtMainThread() {
    if (!qApp) return;
    
    auto coreD = QCoreApplicationPrivate::get(qApp);
    coreD->mainThread = nullptr;
    coreD->thread = nullptr;

    // 清理线程局部存储
    QThreadStorage<void*>::destroy();
}

二、注销QML注册的C++类型 #

qmlRegisterType注册的类型存储在进程全局的私有管理器中，无官方注销接口，需通过私有API清空：

Qt 5 实现 #

#include <QtQml/private/qqmltyperegistrar_p.h>

void unregisterQmlTypes() {
    auto registrar = QQmlTypeRegistrar::instance();
    if (!registrar) return;

    // 清空所有注册类型与URI映射
    registrar->m_types.clear();
    registrar->m_uriTypes.clear();
    // 重置类型ID计数器，避免后续注册冲突
    registrar->m_nextTypeId = 0;
}

Qt 6 实现 #

Qt 6改用QQmlMetaTypeManager管理类型：

#include <QtQml/private/qqmlmetatypemanager_p.h>

void unregisterQmlTypes() {
    auto manager = QQmlMetaTypeManager::instance();
    if (!manager) return;

    // 调用私有重置方法清空所有注册
    manager->reset();
}

三、强制卸载Qt DLL #

Qt DLL无法自动卸载的核心原因是进程内仍有未释放的引用（如全局静态对象、线程局部存储残留），可按以下步骤处理：

1. 彻底清理Qt对象：在销毁QApplication后，确保所有Qt派生对象（QObject、QWidget等）都被销毁，可调用qDeleteAll批量清理。
2. 等待线程完全退出：事件循环退出后，调用QThread::wait()确保Qt线程彻底终止，避免线程局部存储残留。
3. 手动卸载DLL：先卸载你的业务DLL，再通过FreeLibrary手动卸载Qt依赖DLL（需用listdlls确认引用计数为0）。

注意：手动卸载Qt DLL存在崩溃风险，若主进程或其他模块仍持有引用，会触发访问错误。

四、优化后的重复执行流程 #

1. 启动未依赖Qt的主进程；
2. 调用LoadLibrary加载业务DLL；
3. 在业务DLL内创建独立线程，线程执行逻辑：
   • 实例化QApplication并启动事件循环exec()；
   • 事件循环退出后，销毁QApplication；
   • 调用resetQtMainThread()重置主线程标记；
   • 调用unregisterQmlTypes()注销QML类型；
   • 销毁所有Qt相关对象，清理内存；
4. 等待线程完全终止；
5. 调用FreeLibrary卸载业务DLL；
6. （可选）手动卸载所有Qt依赖DLL；
7. 主进程可重复执行步骤2-6。

生产环境最优方案 #

上述私有API方案存在版本兼容风险，最可靠的方式是将Qt依赖的业务逻辑封装为独立子进程：每次需要加载时启动子进程，结束时关闭子进程，从根本上隔离Qt的进程全局状态，避免所有残留问题。

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