Qt 网络编程如何采用Http进行通信

在 Qt 框架中进行 HTTP 通信时，最核心的三个类是：

• QNetworkAccessManager: 网络请求的管理者；

• QNetworkRequest: 用于封装请求的细节；

• QNetworkReply: 用于封装服务器返回的响应。

---

一、QNetworkRequest —— 网络请求的描述者

1.1 类定义与作用

QNetworkRequest 是用于封装一次 HTTP 请求的所有元信息的类，包括：

• 请求 URL；
• 请求头部信息；
• 缓存策略；
• 超时属性等。

1.2 构造函数

QNetworkRequest();QNetworkRequest(const QUrl &url);

通常我们直接传入目标地址：

QNetworkRequest request(QUrl(\"https://api.example.com/data\"));

1.3 设置请求头

通过 setRawHeader() 或 setHeader() 设置常用 HTTP 头：

request.setHeader(QNetworkRequest::ContentTypeHeader, \"application/json\");request.setRawHeader(\"User-Agent\", \"MyQtApp/1.0\");

常用枚举值有：

Header 枚举 说明 ContentTypeHeader 设置 MIME 类型（如 JSON） UserAgentHeader 客户端信息 ContentLengthHeader 设置正文长度 LocationHeader 重定向位置

1.4 其他属性设置

可以用 setAttribute() 设置附加属性，如：

request.setAttribute(QNetworkRequest::FollowRedirectsAttribute, true);

---

二、QNetworkReply —— 网络响应的容器

2.1 类定义与作用

QNetworkReply 是 QIODevice 的子类，用于接收并读取来自服务器的响应内容。

它包含：

• 响应状态码；
• 响应头部；
• 响应体数据；
• 网络错误信息等。

2.2 读取响应内容

最常见的用法是等待请求完成后读取所有数据：

QByteArray response = reply->readAll();

配合事件循环等待异步完成：

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

2.3 错误处理

if (reply->error() != QNetworkReply::NoError) { qWarning() << \"Request failed:\" << reply->errorString();}

QNetworkReply::NetworkError 提供了丰富的错误枚举，例如：

• ConnectionRefusedError
• TimeoutError
• HostNotFoundError
• ContentNotFoundError

2.4 获取状态码和头部

int statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();QString contentType = reply->header(QNetworkRequest::ContentTypeHeader).toString();

---

三、结合示例讲解完整流程

以下是一个完整的 GET 请求流程代码，并在每步配合类讲解。

#include #include #include #include #include #include int main(int argc, char *argv[]){ QCoreApplication a(argc, argv); // 1. 创建网络管理器 QNetworkAccessManager manager; // 2. 构建请求 QUrl url(\"https://jsonplaceholder.typicode.com/posts/1\"); QNetworkRequest request(url); // 设置请求头 request.setRawHeader(\"User-Agent\", \"QtNetworkClient/1.0\"); request.setHeader(QNetworkRequest::ContentTypeHeader, \"application/json\"); // 3. 发送 GET 请求 QNetworkReply *reply = manager.get(request); // 4. 等待请求完成（阻塞） QEventLoop loop; QObject::connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit); loop.exec(); // 5. 处理响应 if (reply->error() == QNetworkReply::NoError) { QByteArray data = reply->readAll(); int statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt(); qDebug() << \"Status:\" << statusCode; qDebug() << \"Response:\" << data; } else { qWarning() << \"Network error:\" << reply->errorString(); } // 6. 清理资源 reply->deleteLater(); return 0;}

---

四、进阶用法拓展

4.1 POST 请求（发送表单或 JSON）

QByteArray json = R\"({\"title\": \"foo\", \"body\": \"bar\"})\";request.setHeader(QNetworkRequest::ContentTypeHeader, \"application/json\");QNetworkReply *reply = manager.post(request, json);

4.2 异步请求处理

推荐用信号槽非阻塞处理：

QObject::connect(reply, &QNetworkReply::finished, []() { qDebug() << \"Request finished!\";});

---

五、总结

类名 作用 QNetworkRequest 描述 HTTP 请求，包括 URL、header、属性等 QNetworkReply 封装服务器响应，包括数据、状态码、错误等 用法核心 发出请求（GET/POST）后读取 reply 内容