在 Qt DLL 插件中加载 DLL 的正确方法：以 HTTPS 支持为例

吃面不喝汤66

于 2024-07-07 22:21:50 发布

阅读量978

点赞数 7

文章标签： qt c++

本文链接：https://blog.csdn.net/mbs6176966/article/details/140253486

版权

在开发 Qt 应用程序时，特别是涉及网络和 HTTPS 请求的功能时，可能需要加载 OpenSSL 的特定动态链接库（DLL），例如 libcrypto-1_1.dll 和 libssl-1_1.dll。在开发独立可执行文件时，将这些 DLL 放在可执行文件的同一目录下通常就足够了。然而，当使用 Qt DLL 插件时，确保这些库正确加载需要额外的步骤。

常见问题与解决方案

一个常见的问题是，简单地将 OpenSSL 库放在插件目录下并不足以让 Qt 的网络框架识别并使用它们。这会导致尝试进行 HTTPS 请求时出现诸如“Failed to load OpenSSL”或“TLS initialization failed”的错误。以下步骤将帮助你解决这些问题。

分步指南

添加库路径

确保包含 OpenSSL 库的目录已添加到 Qt 的库路径中。可以使用 QApplication::addLibraryPath 实现：
```
if (_tcslen(szNsisPluginDir) > 0) {
    QApplication::addLibraryPath(tstringToQString(szNsisPluginDir));
}
```
设置环境变量 PATH

设置环境变量 PATH 以包含 OpenSSL 库的目录。这确保操作系统在尝试加载库时能够找到它们：
```
qputenv("PATH", (tstringToQString(szNsisPluginDir)).toUtf8());
```

手动加载库

即使设置了库路径和环境变量，仍然可能需要使用 QLibrary 显式加载这些库，以确保它们对 Qt 网络框架可用：

QLibrary cryptoLib(pluginDir + "/libcrypto-1_1.dll");
QLibrary sslLib(pluginDir + "/libssl-1_1.dll");

if (!cryptoLib.load() || !sslLib.load()) {
    QMessageBox::critical(nullptr, "OpenSSL Error", "Failed to load OpenSSL libraries.");
    return;
}

动态链接库加载机制

即使 QLibrary 成功加载了 libcrypto-1_1.dll 和 libssl-1_1.dll，仍然需要设置环境变量 PATH。这是因为动态链接库的加载机制和依赖关系的解析方式导致的。以下是一些详细的原因和解释：

显式加载 vs 隐式加载

显式加载：QLibrary 的 load() 方法显式加载了指定的 DLL 文件，但这并不改变全局的 DLL 搜索路径。
隐式加载：QSslSocket 及其底层实现（如 OpenSSL）可能还会隐式加载其他相关的 DLL 文件（例如 libssl 可能依赖 libcrypto）。

环境变量 PATH

设置环境变量 PATH 会影响进程的全局 DLL 搜索路径。这样，任何依赖这些库的函数调用在运行时都能找到这些库。

依赖关系解析

即使通过 QLibrary 成功加载了 libcrypto-1_1.dll 和 libssl-1_1.dll，如果后续的请求（例如 HTTPS 请求）依赖于这些库，它们仍然需要正确解析所有依赖关系。设置 PATH 环境变量确保了所有依赖关系在运行时都能被正确解析。

解决方法

在 Qt 项目中使用 QSslSocket 或其他依赖 OpenSSL 的网络功能时，DLL 插件和 EXE 文件处理方式确实有所不同。以下是一些可能的原因和解决方法：

原因分析

路径设置：
- 对于 EXE 文件，操作系统会自动在 EXE 文件所在目录查找所需的 DLL 文件。
- 对于 DLL 插件，加载路径可能不同，需要手动设置路径。
环境变量：
- qputenv("PATH", ...) 将 DLL 插件目录添加到环境变量 PATH 中，确保操作系统在该目录中查找依赖的 DLL 文件。
Qt 动态库路径：
- QApplication::addLibraryPath() 添加插件目录到 Qt 的库路径，但不一定适用于所有动态库（如 OpenSSL）。