QNetworkReply异常：服务关闭时返回OperationCanceledError而非TimeoutError？

核心原因：场景不符合传输超时的触发条件 #

这既不是代码错误，也不是Qt Bug，而是传输超时（Transfer Timeout）的触发逻辑和你测试的场景不匹配：

• setTransferTimeout() 仅针对已成功建立TCP连接后的数据传输停滞（比如服务器建立连接后迟迟不返回数据）。
• 当你关闭API服务器时，TCP连接根本无法建立（或被立即重置），此时Qt的网络栈会直接终止请求，返回OperationCanceledError——这是因为连接尝试本身被系统层面的错误打断，而非等待传输超时的触发。

代码逻辑说明 #

你的代码本身没有问题，设置超时的方式是正确的：

QByteArray encodedData = data.toUtf8();
QUrl url("http://myapi/jsonrpc");
QNetworkRequest request(url);
request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");

QNetworkAccessManager manager;
manager.setTransferTimeout(500); // 仅针对已连接后的传输停滞
QNetworkReply* reply = manager.post(request, encodedData);

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

if (reply->error() != QNetworkReply::NoError) {
    QString errorMsg = QString("HTTP Network request has failed. Code: ") + QVariant::fromValue(reply->error()).toString();
    delete reply;
    // 此处返回OperationCanceledError是因为连接建立失败被终止
}

QByteArray response = reply->readAll();

触发TimeoutError的正确场景 #

要触发QNetworkReply::TimeoutError，你需要：

• 确保API服务器正常运行，能成功建立TCP连接。
• 让服务器在建立连接后，故意延迟超过500ms再返回数据（或完全不返回数据）。
  此时传输超时机制才会生效，返回预期的TimeoutError。

额外区分建议 #

如果需要区分“连接失败导致的取消”和“主动调用abort()/close()的取消”，可以通过reply->errorString()获取更详细的错误描述，连接失败时的错误信息通常会包含“Connection refused”或类似的系统层面提示。

内容的提问来源于stack exchange，提问作者Erik Šťastný