桌面应用 / 系统课时

处理超时错误和网络状态

处理超时错误和网络状态

本篇学习如何在 Qt 6 网络请求中识别失败原因,并针对 HTTP 错误、连接失败和请求超时等情况提供合理处理。通过 QNetworkReply 状态判断,可以让桌面应用避免无响应或错误提示不明确的问题。

学习目标

  • 区分 HTTP 返回错误和 Qt 网络层错误
  • 掌握 QNetworkReply 错误处理方式
  • 为超时和网络异常设计用户提示逻辑

理解 Qt 网络请求失败类型

Qt 网络请求失败通常来自两个层面:

类型 示例 判断方式
HTTP 错误 404、500 HTTP 状态码
网络错误 DNS 失败、连接断开 QNetworkReply::NetworkError

例如服务器正常响应 404 时,请求本身成功到达服务器,但业务资源不存在;而网络不可用时,客户端甚至无法建立连接。

处理时需要分别判断,否则用户看到的错误信息可能无法反映真实原因。

检查 QNetworkReply 错误状态

网络请求完成后,可以通过 finished 信号获取 QNetworkReply,并检查错误状态。

cpp
#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();
    });
}

预期输出

text
request success

或者在网络失败时:

text
network error: "Host example.com not found"

实际错误文本由系统网络环境决定。

区分 HTTP 状态码和网络错误

QNetworkReply::error() 只能表示 Qt 网络层错误,不能直接代表 HTTP 状态码。

服务器返回 404 时,通常需要读取 HTTP 状态属性:

cpp
QVariant statusCode = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute);

qDebug() << "status:" << statusCode.toInt();

预期输出

text
status: 404

因此业务判断通常采用以下顺序:

  1. 先检查 reply->error() 是否存在网络错误。
  2. 网络层正常时,再读取 HTTP 状态码。
  3. 根据状态码决定显示登录失效、资源不存在或服务器异常等提示。

处理请求超时

QNetworkAccessManager 本身不会自动为所有请求设置统一超时,应用通常需要使用 QTimer 管理超时逻辑。

cpp
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";
    }
});

预期输出

text
request timeout

其中 <TIME> 表示实际项目中的超时时间,例如几秒到几十秒,应该根据接口响应特点调整。

设计用户可理解的错误提示

网络异常处理不应该直接展示底层错误字符串。桌面应用通常需要转换为用户可以理解的信息。

技术原因 用户提示
无网络连接 请检查网络连接
请求超时 服务响应较慢,请稍后重试
HTTP 401 登录状态已失效
HTTP 500 服务暂时不可用

同时,开发调试阶段可以记录详细日志,生产环境只展示必要信息,避免暴露服务器细节。

避免常见网络处理问题

不要只判断 HTTP 状态码,因为网络失败时根本不会产生有效状态码。也不要在请求失败后立即重复请求,需要结合错误类型决定是否重试。

对于需要长期运行的桌面程序,还应监听网络状态变化,在恢复连接后重新加载必要数据,而不是让用户反复点击刷新。

正确处理网络错误后,Qt 应用可以在断网、服务器异常和响应延迟等情况下保持稳定交互体验。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理超时错误和网络状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通