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引擎完成网页浏览-腾讯云开发者社区-腾讯云