开发日常 | 解决SSL缺库导致https失败的问题
使用Qt的https(get,post,put等)请求时报
TLS initialization failed
错误。
开发环境
- Windows10 64位
- Qt 5.12.1
- MSVC 2017编译器(版本:15.0)
发现问题
- 在带开发环境的电脑上运行没问题,而移植到其他系统则有问题,报SSL错误,导致https请求不工作。
qt.network.ssl: QSslSocket::connectToHostEncrypted: TLS initialization failed.
问题分析
- 根据打印的错误提示找到对应源码。
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();
-
如果
supportsSsl
函数返回false时打印错误(警告)信息,就不再执行后续操作了,于是继续查看supportsSsl
函数。
/* 如果此平台支持SSL,则返回true;否则,返回false。
* 如果平台不支持SSL,套接字将失败在连接阶段。
bool QSslSocket::supportsSsl()
return QSslSocketPrivate::supportsSsl();
bool QSslSocketPrivate::supportsSsl()
return ensureLibraryLoaded();
-
ensureLibraryLoaded
实现。
bool QSslSocketPrivate::ensureLibraryLoaded()
if (!q_resolveOpenSslSymbols())
return false;
return true;
-
由于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;
-
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;
-
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);