如何指定Qt从指定文件夹加载OpenSSL DLL文件

兄弟，你碰到的这个情况确实是Qt的一个已知bug，官方已经有相关记录了。针对这个问题，我给你几个靠谱的解决方案，能让Qt乖乖从你指定的DLL子文件夹里加载libeay32.dll和ssleay32.dll：

方法1：手动设置DLL搜索路径（首推） #

在你的程序启动的最早期——比如main()函数的第一行，甚至在实例化QApplication之前——调用Windows的API，把你的DLL子文件夹添加到系统的DLL搜索路径里。这样系统会优先在这个路径里查找需要的DLL，就不会跑去别的地方找旧版本了。

示例代码如下：

#include <windows.h>

int main(int argc, char *argv[])
{
    // 把DLL子文件夹加入搜索路径
    SetDllDirectoryA("DLL");

    QApplication a(argc, argv);
    // ... 你的业务代码
    return a.exec();
}

注意：如果用相对路径，要保证它是相对于程序的工作目录的；要是用绝对路径，直接写完整路径就行。

方法2：用QLibrary手动加载OpenSSL库 #

在使用QSslSocket之前，手动用Qt的QLibrary去加载你指定路径下的两个OpenSSL DLL。这样Qt就会使用你加载的这个版本，不会再自己去系统里找其他版本了。

示例代码：

#include <QLibrary>
#include <QSslSocket>

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

    // 手动加载DLL子文件夹里的OpenSSL库
    QLibrary libEAY("DLL/libeay32.dll");
    QLibrary libSSLEAY("DLL/ssleay32.dll");
    
    if (libEAY.load() && libSSLEAY.load()) {
        qDebug() << "OpenSSL DLLs 成功从DLL文件夹加载！";
    } else {
        qDebug() << "加载OpenSSL DLL失败：" << libEAY.errorString() << libSSLEAY.errorString();
    }

    // 之后再正常使用QSslSocket
    QSslSocket socket;
    // ... 你的socket相关逻辑

    return a.exec();
}

这个方法的好处是能明确控制加载路径，还能直接拿到加载成功与否的反馈，方便排查问题。

方法3：调整清单文件（进阶尝试） #

虽然你已经修改过清单，但可以试试给file元素加上path属性，明确指定子文件夹路径：

<file name="libeay32.dll" path="DLL"/>
<file name="ssleay32.dll" path="DLL"/>

不过要注意，因为那个Qt的bug，这种方式在部分版本里可能不生效，所以还是前两种方法更稳妥。

另外还要提醒你：一定要确保DLL子文件夹里的两个OpenSSL DLL版本，和你使用的Qt编译时依赖的OpenSSL版本兼容——版本不匹配哪怕路径对了也会加载失败，这点可别忽略了！

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