桌面应用 / 系统课时
用网络模块发起 GET 请求
用网络模块发起 GET 请求
桌面应用读取天气、版本信息或业务数据时,网络请求不能阻塞界面线程。本节用 QNetworkAccessManager 发起 GET 请求,通过 QNetworkReply 在响应完成后读取状态码和数据,并掌握 Qt 网络 API 的异步生命周期。
学习目标
- 使用
QNetworkRequest与QNetworkAccessManager::get()发起 HTTP GET 请求 - 在
QNetworkReply::finished后读取响应并处理网络错误 - 正确管理
QNetworkAccessManager和QNetworkReply的生命周期
准备 Network 模块
Qt 的网络访问类位于 Network 模块。CMake 项目至少需要找到并链接 Qt6::Network。下面是片段示例,需要放入已有目标的 CMakeLists.txt 中:
find_package(Qt6 REQUIRED COMPONENTS Core Network)
target_link_libraries(my_app PRIVATE Qt6::Core Qt6::Network)配置生效后,编译器才能解析 QNetworkAccessManager、QNetworkRequest 和 QNetworkReply 等类型。验证方式是重新配置并构建项目,不再出现 Network 头文件或链接符号缺失错误。
理解异步请求链路
QNetworkAccessManager::get() 会立即返回一个 QNetworkReply*,真正的网络传输随后由事件循环驱动。因此不能在 get() 后立刻假设响应数据已经完整,而应等待 QNetworkReply::finished。

实际项目通常让一个 QNetworkAccessManager 随窗口或服务对象长期存在,而不是每发一次请求就临时创建。回复对象则对应一次请求,处理结束后使用 deleteLater() 安全释放。
发起 GET 并接收响应
下面示例使用公开测试接口 https://httpbin.org/get?source=qt6。程序启动后发送请求,响应完成时检查网络错误,再读取 JSON 中回显的查询参数。需要能访问互联网,并保证系统 TLS 环境正常。
#include <QCoreApplication>
#include <QDebug>
#include <QJsonDocument>
#include <QJsonObject>
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QNetworkRequest>
#include <QUrl>
int main(int argc, char *argv[])
{
QCoreApplication app(argc, argv);
QNetworkAccessManager manager;
QNetworkRequest request(QUrl("https://httpbin.org/get?source=qt6"));
QNetworkReply *reply = manager.get(request);
QObject::connect(reply, &QNetworkReply::finished, &app, [&app, reply]() {
const int statusCode =
reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();
if (reply->error() != QNetworkReply::NoError) {
qWarning().noquote() << "request failed:" << reply->errorString();
reply->deleteLater();
app.quit();
return;
}
const QJsonDocument document = QJsonDocument::fromJson(reply->readAll());
const QString source =
document.object().value("args").toObject().value("source").toString();
qInfo().noquote() << "status:" << statusCode;
qInfo().noquote() << "source:" << source;
reply->deleteLater();
app.quit();
});
return app.exec();
}预期输出
status: 200
source: qt6实际网络异常时不会得到上述成功输出,而会进入错误分支并打印 errorString()。状态码也只有在服务器确实返回 HTTP 响应时才有意义,因此不要把“有状态码”和“请求成功”混为一谈。
处理回复时的关键边界
QNetworkReply 归属一次具体请求。需要读取完整响应体时,可在 finished 后调用 readAll();若处理大文件或流式下载,则更适合监听 readyRead 分批消费数据。
不要在请求尚未结束前销毁 QNetworkAccessManager,否则未完成的回复会被终止。也不要在 finished 回调里直接 delete reply,使用 deleteLater() 让 Qt 在安全时机回收对象。GUI 程序中同样遵循这套模式,只是把结果更新到界面控件,而不是调用 app.quit()。