Qt中https的使用，报错TLS initialization failed和不能打开ssl.lib问题解决

前言

在现代应用程序中，安全地传输数据变得越来越重要。Qt提供了一套完整的网络API来支持HTTP和HTTPS通信。然而，在实际开发过程中，开发者可能会遇到SSL相关的错误，例如“TLS initialization failed”，cant't open ssl.lib等问题。本文将介绍如何在Qt中使用HTTPS进行网络访问，网上搜到的结果大都是错的。这里并提供解决TLS初始化失败和SSL库问题的方法。

一、Qt中使用HTTPS的基本概念

Qt使用QNetworkAccessManager和QNetworkReply类来处理网络请求。对于HTTPS请求，Qt会自动使用SSL/TLS进行加密通信。以下是使用HTTPS的基本步骤：

1. 创建QNetworkAccessManager实例。
2. 使用get()、post()等方法发起请求。
3. 连接finished()信号以处理响应。
4. 检查QNetworkReply的状态和错误。

二、TLS初始化失败的原因

TLS初始化失败通常是因为Qt没有正确配置或找到SSL库。这可能是由于以下原因：

• 缺少必要的SSL库文件。
• 编译Qt时未启用SSL支持。
• 系统环境变量未正确设置。

三、解决TLS初始化失败的步骤

确保你的项目中包含了网络模块（core和network模块通常默认包含SSL支持）。

注意，你的yourprj.pro工程文件配置中只需要： QT += network即可。不需要向网上说的那样又是配置CONFIG += openssl又是增加LIBS += -Llib -lssl -lcrypto。这样搞反倒是错的，会报can't open ssl.lib。其实关于ssl的库qt安装时已经包含了，编译时也会自动链接成功，编译成功。

在你的Qt应用程序中，尝试创建一个QSslSocket或QSslConfiguration对象，并使用它来发起HTTPS请求。如果Qt支持SSL，这些类应该能够正常使用。能否编译通过，编译通过则没问题。

唯一需要注意的是：

运行后访问https报错，提示TLS initialization failed。这是因为qt自带的libssl-1_1.dll很扯，位置在Qt\Qt5.14.2\Tools\QtCreator\bin\libssl-1_1.dll, 是个32位的库，提供还不提供全啊，缺少64位的库。咋知道它是32位的库？简单办法文本打开后看到PE..L....的内容，说明它是32位的库（64位的库打开后看二进制能看到PE..d..的内容）。解决办法也简单，网上找到64位的库，名字叫libssl-1_1-x64.dll 和libcrypto-1_1-x64.dll，下载后把它放入你的工具链的bin目录下，我的是在 Qt\Qt5.14.2\5.14.2\msvc2017_64\bin下。

简单使用

以下是一个简单的示例，展示如何在Qt中发起HTTPS请求：

首先在工程的pro文件中，增加：

QT += network

包含相应的头文件： 

#include <QNetworkAccessManager>
#include <QNetworkRequest>
#include <QNetworkReply>

#include <QCoreApplication>
#include <QNetworkAccessManager>
#include <QNetworkRequest>
#include <QNetworkReply>
#include <QDebug>int main(int argc, char *argv[]) {QCoreApplication app(argc, argv);// 创建网络访问管理器QNetworkAccessManager manager;// 创建请求QNetworkRequest request(QUrl("https://www.example.com"));request.setAttribute(QNetworkRequest::FollowRedirectsAttribute, true);// 发起HTTPS GET请求QNetworkReply *reply = manager.get(request);// 连接信号以处理响应QObject::connect(reply, &QNetworkReply::finished, [&]() {if (reply->error() == QNetworkReply::NoError) {qDebug() << "HTTPS request succeeded!";qDebug() << "Response:" << reply->readAll();} else {qDebug() << "HTTPS request failed with error:" << reply->errorString();}reply->deleteLater();});// 连接错误信号QObject::connect(reply, &QNetworkReply::errorOccurred, [&](QNetworkReply::NetworkError error) {qDebug() << "Error occurred:" << error;});// 启动事件循环return app.exec();
}

示例中并没有设置SSL配置，因为大多数情况下Qt会自动处理SSL配置。不配置也行。但是，如果你需要自定义SSL配置，可以这样： 

// 获取默认SSL配置
QSslConfiguration sslConfig = QSslConfiguration::defaultConfiguration();// 自定义SSL配置，例如信任特定的CA证书
sslConfig.setPeerVerifyMode(QSslSocket::VerifyPeer);
sslConfig.setProtocol(QSsl::TlsV1_2); // 指定使用TLS 1.2协议// 应用SSL配置到请求
request.setSslConfiguration(sslConfig);

自定义SSL配置通常只在需要特殊配置的情况下使用，例如在自签名证书或特定协议版本的情况下。对于大多数HTTPS请求，Qt的默认配置足够。 

下载文件示例

实现一个通过https链接下载文件的功能：

mainwindows.h头文件中增加：

private:Ui::MainWindow *ui;QTcpServer *server;QTcpSocket *clientSocket;QNetworkAccessManager *networkManager;QNetworkReply *networkReply;QFile *m_file;QString m_videoUrl;
}

void MainWindow::onDownloadProgress(qint64 bytesReceived, qint64 bytesTotal)
{if (bytesTotal > 0) {int progress = static_cast<int>((bytesReceived * 100) / bytesTotal);ui->te_result->append(QString("Download progress: %1%").arg(progress));ui->progress->setValue(progress);}
}void MainWindow::onFinished()
{if (networkReply->error()) {ui->te_result->append(QString("Download failed: %1").arg(networkReply->errorString()));} else {m_file->write(networkReply->readAll());m_file->close();ui->te_result->append("Download completed");}networkReply->deleteLater();networkReply = nullptr;if (m_file) {m_file->deleteLater();m_file = nullptr;}
}void MainWindow::on_btnDown_clicked()
{// 开始下载视频if(!m_videoUrl.isEmpty()){ui->te_result->append("begin download:");QUrl url(m_videoUrl);QNetworkRequest request(url);networkReply = networkManager->get(request);connect(networkReply, &QNetworkReply::downloadProgress, this, &MainWindow::onDownloadProgress);connect(networkReply, &QNetworkReply::finished, this, &MainWindow::onFinished);// 创建文件m_file = new QFile("downloaded_video.mp4", this);if (!m_file->open(QIODevice::WriteOnly)) {ui->te_result->append("Failed to open file for writing");delete m_file;m_file = nullptr;return;}}else{ui->te_result->append("begin download:");ui->te_result->append("error,no videoUrl!");return;}}

其他资源

QT5.14.2使用webkit引擎完成网页浏览-腾讯云开发者社区-腾讯云