桌面应用 / 系统课时
提交 POST 请求和请求头
提交 POST 请求和请求头
调用登录、创建资源或提交表单接口时,除了 URL,还要同时发送请求体和请求头。本节使用 Qt 6 组装 JSON 请求体,设置 Content-Type 与 Authorization,再通过 QNetworkAccessManager::post() 异步提交并验证服务端收到的数据。
学习目标
- 使用
QJsonObject和QJsonDocument生成 JSON 请求体 - 设置
Content-Type、认证等常见 HTTP 请求头 - 通过
QNetworkReply检查 POST 请求结果并释放回复对象
准备 Network 模块
POST 请求同样依赖 Qt Network。下面是 CMake 片段示例,应放入已有项目并把 my_app 替换为实际目标名:
find_package(Qt6 REQUIRED COMPONENTS Core Network)
target_link_libraries(my_app PRIVATE Qt6::Core Qt6::Network)重新配置项目后能正常编译包含 Network 头文件的源代码,即可确认模块链接生效。
组装请求头和 JSON 请求体
QNetworkRequest 保存 URL 和请求元数据,请求体则作为 QByteArray 传给 post()。发送 JSON 时,Content-Type 应明确为 application/json;令牌等非标准字段可通过 setRawHeader() 设置。
请求头和请求体职责不同:请求头描述数据格式、认证和缓存等元信息,请求体承载本次提交的业务数据。认证令牌不应硬编码在源码中,生产项目通常从安全存储或登录结果中获取。
发送 POST 请求
下面示例向公开测试接口 https://httpbin.org/post 提交 JSON。<TOKEN> 是演示占位符,真实项目应替换为接口实际要求的令牌。程序只验证服务端回显的 JSON 内容,不依赖认证头是否被回显。
#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;
QJsonObject payload;
payload.insert("name", "Qt Client");
payload.insert("enabled", true);
const QByteArray body = QJsonDocument(payload).toJson(QJsonDocument::Compact);
QNetworkRequest request(QUrl("https://httpbin.org/post"));
request.setHeader(QNetworkRequest::ContentTypeHeader,
QStringLiteral("application/json"));
request.setRawHeader("Authorization", "Bearer <TOKEN>");
QNetworkReply *reply = manager.post(request, body);
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 QJsonObject echoed = document.object().value("json").toObject();
qInfo().noquote() << "status:" << statusCode;
qInfo().noquote() << "name:" << echoed.value("name").toString();
qInfo().noquote() << "enabled:" << echoed.value("enabled").toBool();
reply->deleteLater();
app.quit();
});
return app.exec();
}预期输出
status: 200
name: Qt Client
enabled: true测试服务不可访问、TLS 失败或代理配置异常时,程序会进入错误分支,错误文本随环境变化。生产代码还应根据接口契约区分 2xx、4xx、5xx,并对响应 JSON 做格式校验。
选择请求头设置方式
setHeader() 适合 Qt 已定义的常见头,例如 Content-Type;setRawHeader() 适合 Authorization、自定义追踪 ID 等原始头字段。二者最终都会写入 HTTP 请求,但前者能让代码直接使用 Qt 的已知头枚举。
同一个 QNetworkAccessManager 可以连续发送多个请求。每次 post() 返回独立的 QNetworkReply,因此并发请求时应把业务上下文与对应 reply 绑定,不能只依靠“最后一次请求”的成员变量判断响应属于谁。