基于Qt开发的http/https客户端

成果展示：

使用Qt开发HTTP客户端主要依赖QNetworkAccessManager、QNetworkRequest和QNetworkReply三大核心类。以下是具体实现要点及最佳实践：

一、核心类与基础流程​​

1.QNetworkAccessManager​​

作为HTTP请求的管理者，负责异步处理网络通信，支持GET/POST/PUT/DELETE等方法。需在类成员中声明并通过new创建：

QNetworkAccessManager *manager = new QNetworkAccessManager(this);

2.QNetworkRequest​​

封装请求的元数据，包括URL、请求头（Headers）和属性。需设置目标地址及内容类型：

QNetworkRequest request(QUrl("http://example.com/api"));
request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");

3.QNetworkReply​​

接收服务器响应，通过信号finished()触发数据处理。需在槽函数中读取数据并释放对象：

connect(reply, &QNetworkReply::finished, [=]() {
    if (reply->error() == QNetworkReply::NoError) {
        QByteArray data = reply->readAll();
        qDebug() << "Response:" << data;
    }
    reply->deleteLater();
});

二、GET与POST请求实现​​

​​1. GET请求​​

​​步骤​​
通过manager->get(request)发送请求，URL可直接包含查询参数：

QNetworkReply *reply = manager->get(QNetworkRequest(QUrl("http://example.com/data?id=1")));

2. POST请求​​

• 数据提交​​
  使用manager->post(request, data)发送表单或JSON数据：

QByteArray postData = "username=admin&password=123456";  // 表单数据
// 或 JSON格式
postData = QJsonDocument(jsonObject).toJson();
QNetworkReply *reply = manager->post(request, postData);

• 头部设置​​
  根据数据类型调整Content-Type，例如application/x-www-form-urlencoded或application/json

三、响应处理与错误机制​​

1.数据读取​​

在finished()槽函数中通过reply->readAll()获取完整响应，注意编码转换（如UTF-8）：

QTextCodec *codec = QTextCodec::codecForName("utf8");
QString text = codec->toUnicode(reply->readAll());

2.错误处理​​

检查reply->error()并记录错误信息，处理网络超时、SSL证书异常等场景：

if (reply->error() != QNetworkReply::NoError) {
    qDebug() << "Error:" << reply->errorString();
}

四、高级功能扩展​​

1.HTTPS支持​​

需在项目配置文件（.pro）中添加QT += network，并确保系统SSL证书有效：

QT += network

2.设置SSL协议版本

    QSslConfiguration sslConfig = request.sslConfiguration();
    sslConfig.setProtocol(QSsl::AnyProtocol); // 设置SSL协议版本
    request.setSslConfiguration(sslConfig);

3.设置同步请求

    QEventLoop loop;
    connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
    loop.exec();

五、实践注意事项​​

• 线程安全​​：避免在主线程中执行耗时网络操作，建议使用QThread或异步信号槽。
• ​​资源释放​​：务必调用reply->deleteLater()防止内存泄漏。
• 用户代理与自定义头​​：通过setRawHeader()设置UA或认证信息（如Authorization: Bearer token）。

六、完整代码示例：

1.界面设计：

2.mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>


QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow

{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
public slots:
    void click_sendButton();
    void requestHttp(const QString url,QString body);
    void requestHttps(const QString url,QString body);


private:
    Ui::MainWindow *ui;
};

#endif // MAINWINDOW_H

3.mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include<QtNetwork/QHostAddress>
#include <QtNetwork/QNetworkAccessManager>
#include <QtNetwork/QNetworkReply>
#include<QEventLoop>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);
    connect(ui->sendButton,&QPushButton::clicked,this,&MainWindow::click_sendButton);
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::click_sendButton()
{
    QString url = ui->urlEdit->text();
    QString body = ui->bodyEdit->toPlainText();

    //requestHttp(url,body);
    requestHttps(url,body);
}

void MainWindow::requestHttp(const QString url, QString body)
{
    QString requestType = ui->requestComBox->currentText();
    QString params = ui->gsEdit->text();
    QString header = ui->headercomBox->currentText();

    QNetworkAccessManager networkManager;
    QNetworkRequest request;
    request.setUrl(QUrl(url));
    //请求头token设置
    request.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("application/json;charset=utf-8"));
    if(header=="Content-Type")
        request.setHeader(QNetworkRequest::ContentTypeHeader, QVariant(params));
    else
        request.setRawHeader(header.toUtf8(), params.toUtf8());

    QNetworkReply *reply;
    if(requestType=="Post")
        reply = networkManager.post(request, body.toUtf8());
    else if(requestType=="Get")
        reply = networkManager.get(request);

    //请求响应结果
    connect(reply, &QNetworkReply::finished, [&]() {
        if (reply->error() == QNetworkReply::NoError) {
            QByteArray bytes = reply->readAll();
            QString msg = QString::fromUtf8(bytes);
            ui->resultEdit->append(msg);
        }
        else {
            qDebug() << "Error:" << reply->errorString();
            QVariant statusCodeV = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
            //statusCodeV是HTTP服务器的相应码，reply->error()是Qt定义的错误码，可以参考QT的文档
            QString data = "Request errors, statusCode:" + QString::number(statusCodeV.toInt()) + ", errorCode : " + QString::number((int)reply->error());
            ui->resultEdit->append(data);
        }
        reply->deleteLater();
    });

    //开启事件循环，直到请求完成
    QEventLoop loop;
    connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
    loop.exec();
}

void MainWindow::requestHttps(const QString url, QString body)
{
    QString requestType = ui->requestComBox->currentText();
    QString params = ui->gsEdit->text();
    QString header = ui->headercomBox->currentText();

    QNetworkAccessManager networkManager;
    QNetworkRequest request;
    request.setUrl(QUrl(url));
    request.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("application/json;charset=utf-8"));
    if(header=="Content-Type")
        request.setHeader(QNetworkRequest::ContentTypeHeader, QVariant(params));
    else
        request.setRawHeader(header.toUtf8(), params.toUtf8());

    QSslConfiguration sslConfig = request.sslConfiguration();
    sslConfig.setProtocol(QSsl::AnyProtocol); // 设置SSL协议版本
    request.setSslConfiguration(sslConfig);

    QNetworkReply *reply;
    if(requestType=="Post")
        reply = networkManager.post(request, body.toUtf8());
    else if(requestType=="Get")
        reply = networkManager.get(request);

    //请求响应结果
    connect(reply, &QNetworkReply::finished, [&]() {
        if (reply->error() == QNetworkReply::NoError) {
            QByteArray bytes = reply->readAll();
            QString msg = QString::fromUtf8(bytes);
            ui->resultEdit->append(msg);
        }
        else {
            qWarning() << "Error:" << reply->errorString();
            QVariant statusCodeV = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
            //statusCodeV是HTTP服务器的相应码，reply->error()是Qt定义的错误码，可以参考QT的文档
            QString data = "Request errors, statusCode:" + QString::number(statusCodeV.toInt()) + ", errorCode : " + QString::number((int)reply->error());
            ui->resultEdit->append(data);
        }
        reply->deleteLater();
    });

    //开启事件循环，直到请求完成
    QEventLoop loop;
    connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
    loop.exec();
}

4.main.cpp

#include "mainwindow.h"
#include <QApplication>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
    return a.exec();
}

更多Qt开发实战教程，持续更新中。