Qt实现HTTP GET/POST/PUT/DELETE请求

news2025/4/3 3:11:07

引言

在现代应用程序开发中，HTTP请求是与服务器交互的核心方式。Qt作为跨平台的C++框架，提供了强大的网络模块（QNetworkAccessManager），支持GET、POST、PUT、DELETE等HTTP方法。本文将手把手教你如何用Qt实现这些请求，并附完整代码示例。

环境准备

Qt版本：Qt 5.x 或 Qt 6.x（本文代码兼容两者）
模块配置：在.pro文件中添加 QT += network

一、Qt网络模块核心类

QNetworkAccessManager

Qt通过QNetworkAccessManager管理HTTP请求，其特点包括：

异步处理，通过信号槽机制返回结果。
支持HTTPS、Cookie、代理等高级功能。
自动管理线程安全。

二、实现HTTP请求的通用步骤

创建QNetworkAccessManager对象。
构建请求对象QNetworkRequest并设置URL/Header。
发送请求，获取QNetworkReply对象。
绑定finished()信号处理响应数据。

三、HTTP请求方法实现

1. GET请求：获取资源

void sendGetRequest(const QString& url) {
    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
    QNetworkRequest request;
    request.setUrl(QUrl(url));
    
    QNetworkReply *reply = manager->get(request);
    connect(reply, &QNetworkReply::finished, [=]() {
        if (reply->error() == QNetworkReply::NoError) {
            QByteArray data = reply->readAll();
            qDebug() << "GET Response:" << data;
        } else {
            qDebug() << "GET Error:" << reply->errorString();
        }
        reply->deleteLater();
        manager->deleteLater();
    });
}

2. POST请求：提交数据

发送JSON数据

void sendPostRequest(const QString& url, const QJsonObject& json) {
    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
    QNetworkRequest request(url);
    request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");
    
    QByteArray postData = QJsonDocument(json).toJson();
    QNetworkReply *reply = manager->post(request, postData);
    
    connect(reply, &QNetworkReply::finished, [=]() {
        // 处理响应（同GET示例）
    });
}

3. PUT请求：更新资源

void sendPutRequest(const QString& url, const QByteArray& data) {
    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
    QNetworkRequest request(url);
    request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");
    
    QNetworkReply *reply = manager->put(request, data);
    // 响应处理逻辑同上
}

4. DELETE请求：删除资源

void sendDeleteRequest(const QString& url) {
    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
    QNetworkRequest request(url);
    
    QNetworkReply *reply = manager->deleteResource(request);
    // 响应处理逻辑同上
}

四、关键问题与优化

1. 异步处理与事件循环

避免在回调中阻塞UI线程，可使用QEventLoop实现同步请求（谨慎使用）。

使用QTimer设置请求超时。

//GET为例
void sendGetRequest(const QString& url) {
    QNetworkAccessManager *manager = new QNetworkAccessManager(this);
    QNetworkRequest request;
    request.setUrl(QUrl(url));
    
    QNetworkReply *reply = manager->get(request);
    QTimer::singleShot(8000, [&reply](){reply->close();});//请求时间超过8s直接关闭请求
    QEventLoop eventLoop;
    connect(reply, SIGNAL(finished()), &eventLoop, SLOT(quit()));
    eventLoop.exec();
    if(reply->error() != QNetworkReply::NoError)
    {
        QVariant statusCodeV = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
        qDebug("request protobufHttp found error ....code: %d %d\n", statusCodeV.toInt(), (int)reply->error());
    }

    QByeteArray outRet = reply->readAll();

    reply->deleteLater();
    manager->deleteLater();
}