桌面应用 / 系统课时
处理超时错误和网络状态
处理超时错误和网络状态
本篇学习如何在 Qt 6 网络请求中识别失败原因,并针对 HTTP 错误、连接失败和请求超时等情况提供合理处理。通过 QNetworkReply 状态判断,可以让桌面应用避免无响应或错误提示不明确的问题。
学习目标
- 区分 HTTP 返回错误和 Qt 网络层错误
- 掌握 QNetworkReply 错误处理方式
- 为超时和网络异常设计用户提示逻辑
理解 Qt 网络请求失败类型
Qt 网络请求失败通常来自两个层面:
| 类型 | 示例 | 判断方式 |
|---|---|---|
| HTTP 错误 | 404、500 | HTTP 状态码 |
| 网络错误 | DNS 失败、连接断开 | QNetworkReply::NetworkError |
例如服务器正常响应 404 时,请求本身成功到达服务器,但业务资源不存在;而网络不可用时,客户端甚至无法建立连接。
处理时需要分别判断,否则用户看到的错误信息可能无法反映真实原因。
检查 QNetworkReply 错误状态
网络请求完成后,可以通过 finished 信号获取 QNetworkReply,并检查错误状态。
#include <QNetworkAccessManager>
#include <QNetworkReply>
#include <QUrl>
#include <QDebug>
void sendRequest()
{
QNetworkAccessManager *manager = new QNetworkAccessManager;
QNetworkRequest request(QUrl("https://example.com/api/data"));
QNetworkReply *reply = manager->get(request);
QObject::connect(reply, &QNetworkReply::finished, [reply]() {
if (reply->error() != QNetworkReply::NoError) {
qDebug() << "network error:" << reply->errorString();
} else {
qDebug() << "request success";
}
reply->deleteLater();
});
}预期输出
request success或者在网络失败时:
network error: "Host example.com not found"实际错误文本由系统网络环境决定。
区分 HTTP 状态码和网络错误
QNetworkReply::error() 只能表示 Qt 网络层错误,不能直接代表 HTTP 状态码。
服务器返回 404 时,通常需要读取 HTTP 状态属性:
QVariant statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);
qDebug() << "status:" << statusCode.toInt();预期输出
status: 404因此业务判断通常采用以下顺序:
- 先检查 reply->error() 是否存在网络错误。
- 网络层正常时,再读取 HTTP 状态码。
- 根据状态码决定显示登录失效、资源不存在或服务器异常等提示。
处理请求超时
QNetworkAccessManager 本身不会自动为所有请求设置统一超时,应用通常需要使用 QTimer 管理超时逻辑。
QNetworkReply *reply = manager->get(request);
QTimer *timer = new QTimer(reply);
timer->setSingleShot(true);
timer->start(<TIME>);
QObject::connect(timer, &QTimer::timeout, [reply]() {
if (!reply->isFinished()) {
reply->abort();
qDebug() << "request timeout";
}
});预期输出
request timeout其中 <TIME> 表示实际项目中的超时时间,例如几秒到几十秒,应该根据接口响应特点调整。
设计用户可理解的错误提示
网络异常处理不应该直接展示底层错误字符串。桌面应用通常需要转换为用户可以理解的信息。
| 技术原因 | 用户提示 |
|---|---|
| 无网络连接 | 请检查网络连接 |
| 请求超时 | 服务响应较慢,请稍后重试 |
| HTTP 401 | 登录状态已失效 |
| HTTP 500 | 服务暂时不可用 |
同时,开发调试阶段可以记录详细日志,生产环境只展示必要信息,避免暴露服务器细节。
避免常见网络处理问题
不要只判断 HTTP 状态码,因为网络失败时根本不会产生有效状态码。也不要在请求失败后立即重复请求,需要结合错误类型决定是否重试。
对于需要长期运行的桌面程序,还应监听网络状态变化,在恢复连接后重新加载必要数据,而不是让用户反复点击刷新。
正确处理网络错误后,Qt 应用可以在断网、服务器异常和响应延迟等情况下保持稳定交互体验。