解决 Qt 网络 SSL 报错：`cannot call unresolved function` 的终极指南

在使用 Qt 进行网络编程时，尤其是涉及到 HTTPS 或其他 SSL/TLS 加密的连接时，可能会遇到一些令人困扰的错误提示，例如：

复制代码

qt.network.ssl: QSslSocket: cannot call unresolved function SSLv23_client_method
qt.network.ssl: QSslSocket: cannot call unresolved function SSL_CTX_new
qt.network.ssl: QSslSocket: cannot call unresolved function SSL_library_init
qt.network.ssl: QSslSocket: cannot call unresolved function ERR_get_error
qt.network.ssl: QSslSocket: cannot call unresolved function ERR_get_error

这些错误信息清晰地指向了 Qt 的 QSslSocket 在尝试调用 OpenSSL 相关的函数时失败了，原因是它"找不到"或"无法解析"这些函数。这通常意味着您的应用程序无法正确加载或链接到所需的 OpenSSL 库。

本文将深入探讨这些错误发生的原因，并提供一个简单而有效的解决方案，帮助您快速摆脱这些烦恼。

为什么会发生这些错误？

Qt 的 QSslSocket 模块本身并不包含 OpenSSL 的实现。相反，它是一个包装器 ，依赖于您的系统上安装的 OpenSSL 库来提供实际的 SSL/TLS 功能。当 Qt 应用程序尝试使用 SSL 功能时，它会动态加载 OpenSSL 的相关 DLL（在 Windows 上是 libeay32.dll 和 ssleay32.dll，在 Linux 上是 .so 文件，在 macOS 上是 .dylib 文件）。

如果应用程序在运行时无法找到这些库文件，或者找到的版本不兼容，Qt 就会报告上述 cannot call unresolved function 错误。这就像一本字典，如果某个单词的定义缺失了，你就无法理解这个单词。对于 Qt 来说，如果没有找到 OpenSSL 库，或者库中的函数签名与 Qt 期望的不符，它就无法"解析"或"调用"这些函数。

常见原因包括：

缺少 OpenSSL 库： 您的系统或应用程序的部署环境中根本没有 OpenSSL 库文件。
路径问题： OpenSSL 库文件存在，但 Qt 应用程序在运行时无法在预期的路径中找到它们（例如，不在 PATH 环境变量中，或不在应用程序的可执行文件目录或其子目录中）。
版本不匹配： 应用程序编译时使用的 Qt 版本可能与您的系统上安装的 OpenSSL 库版本不兼容。
MinGW/MSVC 运行时库冲突： 对于 Windows 平台，如果您的 Qt 应用程序使用 MinGW 编译，而系统中的某些程序安装了使用 MSVC 编译的 OpenSSL 库，可能会导致兼容性问题。

解决方案：部署必要的 OpenSSL DLLs

最直接、最可靠的解决方案是确保 OpenSSL 库文件与您的应用程序的可执行文件（exe）一起部署。这样，无论用户系统上是否安装了 OpenSSL，或安装了什么版本，您的应用程序都能找到并加载所需的文件。

步骤 1：下载合适的 OpenSSL 库文件

首先，您需要获取适用于您的应用程序的 OpenSSL DLL 文件。对于大多数 Qt 应用程序，推荐从可靠来源下载预编译的 OpenSSL DLL。一个常用的地址是 indy.fulgan.com/SSL/。

进入该网站后，通常会有多个版本可供选择。选择与您的 Qt 版本和编译器（MinGW 或 MSVC）相匹配的最新稳定版本。通常，对于 MinGW 编译的 Qt 应用程序，选择 Win32 或 Win64 对应的 MinGW 版本。

步骤 2：解压并定位关键文件

下载完成后，您会得到一个压缩包（例如 openssl-1.0.2u-i686-w64-mingw32.zip 或类似的文件）。

解压该压缩包。在解压后的目录中，您需要找到以下两个核心 DLL 文件：

libeay32.dll
ssleay32.dll

这两个文件包含了 OpenSSL 的核心功能，是 QSslSocket 正常工作所必需的。

步骤 3：将 DLL 文件放置到应用程序可执行文件目录

这是最关键的一步。将您找到的 libeay32.dll 和 ssleay32.dll 文件复制到您的 Qt 应用程序的 exe 可执行文件所在的目录。

例如，如果你的应用程序可执行文件是 MyApp.exe，并且它位于 C:\MyQtApp\release\ 目录下，那么您应该将这两个 DLL 文件也放到 C:\MyQtApp\release\ 目录下。

验证解决方案

完成上述步骤后，重新运行您的 Qt 应用程序。如果一切顺利，之前出现的 cannot call unresolved function 错误将不再出现，您的 QSslSocket 应该能够正常进行 SSL/TLS 连接。

您还可以通过在应用程序启动时，使用 Qt 的 QSslSocket::supportsSsl() 函数来验证 SSL 支持是否已启用：

cpp 复制代码

#include <QSslSocket>
#include <QDebug>

int main(int argc, char *argv[])
{
    // ... 其他初始化代码 ...

    if (QSslSocket::supportsSsl()) {
        qDebug() << "SSL 支持已启用！";
    } else {
        qDebug() << "SSL 支持未启用。错误：" << QSslSocket::sslLibraryBuildVersionString();
        qDebug() << "SSL 错误消息：" << QSslSocket::sslLibraryVersionString();
    }

    // ... 您的应用程序逻辑 ...

    return a.exec();
}

如果输出显示"SSL 支持已启用！"，则表明您已成功解决了问题。

总结

Qt 网络 SSL 错误 cannot call unresolved function 的本质是 OpenSSL 库的加载问题。通过从可靠来源下载适用于您应用程序的 libeay32.dll 和 ssleay32.dll 文件，并将它们放置在应用程序可执行文件所在的目录，您可以确保 Qt 应用程序在运行时能够找到并正确加载这些必要的库，从而顺利进行 SSL/TLS 加密通信。这个解决方案简单、直接且普遍有效，是解决此类问题的最佳实践。

解决 Qt 网络 SSL 报错：`cannot call unresolved function` 的终极指南