開發日常 | 解決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();
    ...
}

2. 如果supportsSsl函數返回false時打印錯誤(警告)信息，就不再執行後續操作了，於是繼續查看supportsSsl函數。

/* 如果此平臺支持SSL，則返回true;否則,返回false。
 * 如果平臺不支持SSL，套接字將失敗在連接階段。 
 */
bool QSslSocket::supportsSsl()
{
    return QSslSocketPrivate::supportsSsl();
}

bool QSslSocketPrivate::supportsSsl()
{
    return ensureLibraryLoaded();
}

3. ensureLibraryLoaded實現。

bool QSslSocketPrivate::ensureLibraryLoaded()
{
    if (!q_resolveOpenSslSymbols())
        return false;
    ...
    return true;
}

4. 由於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;

    ...

5. 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;
}

6. Qt版本沒有配置opensslv11，所以加載以下的SSL庫操作。依次查找ssleay32和libeay32，如果沒有找到就查找libssl-10和libcrypto-10依此類推直到libssl-7和libcrypto-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君將ssleay32和libeay32庫放到運行目錄下即解決了問題。
• 由於開發環境存在ssleay32和libeay32路徑鏈接，而打包程序又沒有複製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