开发日常 | 解决SSL缺库导致https失败的问题

使用Qt的https(get,post,put等)请求时报 qt.network.ssl: QSslSocket::connectToHostEncrypted: TLS initialization failed 错误。

开发环境

  • Windows10 64位
  • Qt 5.12.1
  • MSVC 2017编译器(版本:15.0)

发现问题

  • 在带开发环境的电脑上运行没问题,而移植到其他系统则有问题,报SSL错误,导致https请求不工作。
qt.network.ssl: QSslSocket::connectToHostEncrypted: TLS initialization failed.

问题分析

  1. 根据打印的错误提示找到对应源码。
void QSslSocket::connectToHostEncrypted(const QString &hostName, quint16 port,
                                        const QString &sslPeerName, OpenMode mode,
                                        NetworkLayerProtocol protocol)
{
    ...
    if (!supportsSsl()) {
        qCWarning(lcSsl, "QSslSocket::connectToHostEncrypted: TLS initialization failed");
        d->setErrorAndEmit(QAbstractSocket::SslInternalError, tr("TLS initialization failed"));
        return;
    }

    d->init();
    ...
}
  1. 如果 supportsSsl 函数返回false时打印错误(警告)信息,就不再执行后续操作了,于是继续查看 supportsSsl 函数。
/* 如果此平台支持SSL,则返回true;否则,返回false。
 * 如果平台不支持SSL,套接字将失败在连接阶段。 
 */
bool QSslSocket::supportsSsl()
{
    return QSslSocketPrivate::supportsSsl();
}

bool QSslSocketPrivate::supportsSsl()
{
    return ensureLibraryLoaded();
}
  1. ensureLibraryLoaded 实现。
bool QSslSocketPrivate::ensureLibraryLoaded()
{
    if (!q_resolveOpenSslSymbols())
        return false;
    ...
    return true;
}
  1. 由于Qt君使用的是windows系统所以选用 loadOpenSslWin32 加载SSL库函数。
bool q_resolveOpenSslSymbols()
{
    ...
#ifdef Q_OS_WIN
    QPair<QSystemLibrary *, QSystemLibrary *> libs = loadOpenSslWin32();
#else
    QPair<QLibrary *, QLibrary *> libs = loadOpenSsl();
#endif
    if (!libs.first || !libs.second)
        // failed to load them
        return false;

    ...
  1. loadOpenSslWin32 实现。
static QPair<QSystemLibrary*, QSystemLibrary*> loadOpenSslWin32()
{
    ...
#if QT_CONFIG(opensslv11)
    // With OpenSSL 1.1 the names have changed to libssl-1_1(-x64) and libcrypto-1_1(-x64), for builds using
    // MSVC and GCC, (-x64 suffix for 64-bit builds).

#ifdef Q_PROCESSOR_X86_64
#define QT_SSL_SUFFIX "-x64"
#else // !Q_PROCESSOFR_X86_64
#define QT_SSL_SUFFIX
#endif // !Q_PROCESSOR_x86_64

    tryToLoadOpenSslWin32Library(QLatin1String("libssl-1_1" QT_SSL_SUFFIX),
                                 QLatin1String("libcrypto-1_1" QT_SSL_SUFFIX), pair);

#undef QT_SSL_SUFFIX

#else // QT_CONFIG(opensslv11)

    // When OpenSSL is built using MSVC then the libraries are named 'ssleay32.dll' and 'libeay32'dll'.
    // When OpenSSL is built using GCC then different library names are used (depending on the OpenSSL version)
    // The oldest version of a GCC-based OpenSSL which can be detected by the code below is 0.9.8g (released in 2007)
    if (!tryToLoadOpenSslWin32Library(QLatin1String("ssleay32"), QLatin1String("libeay32"), pair)) {
        if (!tryToLoadOpenSslWin32Library(QLatin1String("libssl-10"), QLatin1String("libcrypto-10"), pair)) {
            if (!tryToLoadOpenSslWin32Library(QLatin1String("libssl-8"), QLatin1String("libcrypto-8"), pair)) {
                tryToLoadOpenSslWin32Library(QLatin1String("libssl-7"), QLatin1String("libcrypto-7"), pair);
            }
        }
    }
#endif // !QT_CONFIG(opensslv11)

    return pair;
}
  1. Qt版本没有配置 opensslv11 ,所以加载以下的SSL库操作。依次查找 ssleay32libeay32 ,如果没有找到就查找 libssl-10libcrypto-10 依此类推直到 libssl-7libcrypto-7
if (!tryToLoadOpenSslWin32Library(QLatin1String("ssleay32"), QLatin1String("libeay32"), pair)) {
    if (!tryToLoadOpenSslWin32Library(QLatin1String("libssl-10"), QLatin1String("libcrypto-10"), pair)) {
        if (!tryToLoadOpenSslWin32Library(QLatin1String("libssl-8"), QLatin1String("libcrypto-8"), pair)) {
            tryToLoadOpenSslWin32Library(QLatin1String("libssl-7"), QLatin1String("libcrypto-7"), pair);
        }
    }
}

问题解决

  • 找对应平台版本的SSL库,Qt君将 ssleay32libeay32 库放到运行目录下即解决了问题。
  • 由于开发环境存在 ssleay32libeay32 路径链接,而打包程序又没有复制SSL库,导致移植到其他电脑的SSL功能不正常的问题。

一些总结

  • 可以将SSL库与应用程序一起部署,也可以在计算机上安装OpenSSL。
  • 根据不同的Qt版本SSL库可能有所不同。
  • Dependency Walker工具也找不到依赖的库,因为它是运行时加载的库。注:Dependency Walker可以扫描任何32位或64位Windows模块exe,dll,ocx,sys等,并构建所有对象的层次结构树图。
  • SSL库Windows版本下载地址:
https://slproweb.com/products/Win32OpenSSL.html
  • SSL源码地址:
https://github.com/openssl/openssl
  • 如果是mingw版本的SSL库,可在下列路径找到(是你实际的路径):
C:\Qt\Qt5.12.1\Tools\mingw730_64\opt\bin
我来评几句
登录后评论

已发表评论数()

相关站点

热门文章