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

引言

在现代应用程序开发中，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请求的通用步骤

1. 创建QNetworkAccessManager对象。

2. 构建请求对象QNetworkRequest并设置URL/Header。

3. 发送请求，获取QNetworkReply对象。

4. 绑定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();
  }

2. HTTPS支持

• 需在项目中配置SSL证书（QSslConfiguration）。

• 处理sslErrors信号以忽略证书验证（开发环境适用）。