Windows环境下如何将OpenSSL 3.x与Qt（6.2/6.5）链接？

Qt 6.x在Windows下默认绑定Windows安全通道（Schannel），导致之前基于OpenSSL 1.1.1t正常工作的Socket连接出问题？按下面的步骤操作，就能让QSslSocket::sslLibraryVersionString()显示3.x版本：

1. 先理清Qt的OpenSSL支持逻辑 #

官方预编译的Qt 6.x大多自带OpenSSL支持，但默认优先使用Schannel。要切换到OpenSSL，有两种可行方案：自己编译Qt时指定链接OpenSSL 3.x，或者通过环境变量+部署DLL强制切换。

2. 自行编译Qt（最稳定，推荐） #

如果想彻底把控版本兼容性，建议自行编译Qt：

• 下载对应版本的Qt源码（6.2或6.5），同时准备好编译完成的OpenSSL 3.x库（需包含头文件、Debug/Release版的lib文件）
• 打开Qt自带的对应编译器命令提示符（MSVC或MinGW），进入Qt源码根目录
• 执行配置命令，指定OpenSSL路径：

  configure -prefix <你的Qt安装目标路径> -openssl-linked -I <OpenSSL头文件路径> -L <OpenSSL库文件路径> -release
  

  说明：-openssl-linked代表静态链接OpenSSL；若需动态链接，替换为-openssl（后续需部署对应DLL）
• 接着执行nmake（MSVC环境）或mingw32-make（MinGW环境），等待编译完成后安装到指定路径即可

3. 不编译Qt，直接强制切换（快速验证） #

不想折腾编译流程的话，用这个方法快速切换：

• 将OpenSSL 3.x的动态库（libcrypto-3-x64.dll、libssl-3-x64.dll，注意和你的程序位数匹配，32/64位别搞混）放到Qt程序的运行目录（不建议丢系统路径，避免和其他程序冲突）
• 设置环境变量QT_SSL_BACKEND=openssl，强制Qt优先使用OpenSSL而非Schannel
• 可添加以下代码验证效果：

  #include <QSslSocket>
  #include <QDebug>
  
  int main(int argc, char *argv[]) {
      QCoreApplication a(argc, argv);
      qDebug() << "SSL版本:" << QSslSocket::sslLibraryVersionString();
      return a.exec();
  }
  

  运行程序后，若输出3.x版本则说明配置成功

4. 常见踩坑点 #

• 位数必须一致：OpenSSL、Qt程序、编译器的位数（32/64）要完全匹配，否则会出现库加载失败
• DLL名称别混淆：OpenSSL 3.x的DLL名称和1.1.1系列不同，比如3.x是libcrypto-3-x64.dll，1.1.1是libcrypto-1_1-x64.dll，别拿错文件
• 编译Qt时路径要准确：配置命令中的-I和-L必须指向OpenSSL头文件和库文件的正确路径，否则会报链接错误
• 运行时找不到库：检查DLL是否在程序运行目录，或者PATH环境变量是否包含DLL所在路径

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