Qt通过QNetworkRequest下载文件时，Header的使用规范与主机适配问题

问题背景 #

把Qt程序的文件下载目标主机从BlueHost迁移到Siteground后，原代码出现下载失败：QNetworkReply::error()返回值2（ConnectionClosedError），错误信息显示“Connection Closed”。移除代码中request.setRawHeader("User-Agent","Mozilla Firefox")这一行后，下载恢复正常。

疑问解答 #

1. 下载文件时不设置Header或Raw Header是否可行？

完全可行。Qt的QNetworkRequest会自动为请求添加必要的默认Header，比如默认的User-Agent值通常是Qt Network/[Qt版本号]这类标识。只要目标服务器没有强制要求必须携带特定自定义Header，不额外设置Header完全可以正常完成文件下载请求。

2. 为何BlueHost/Hostgator需要该Header而Siteground不需要？

核心是不同主机商的服务器安全策略存在差异：

• BlueHost或Hostgator的服务器可能开启了严格的请求过滤机制（比如WAF规则、爬虫检测），会拦截没有标准浏览器类型User-Agent的请求，以此防范恶意爬取、自动化批量请求等行为。设置Mozilla Firefox的User-Agent会让请求被识别为合法的浏览器请求，从而通过检测。
• Siteground的服务器安全策略相对宽松，或者其过滤规则允许Qt默认的User-Agent标识通过，所以不需要额外设置自定义User-Agent就能正常处理请求。

原代码示例 #

void program::checkForUpdates()
{
    QString versionAddress("https://***.com/file");
    QUrl versionUrl;
    versionUrl = QUrl(versionAddress);
    QNetworkRequest request(versionUrl);
    request.setRawHeader("User-Agent","Mozilla Firefox");
    downloadVersionReply = mNetworkManager->get(request);
    connect(downloadVersionReply, &QNetworkReply::finished, this, &program::downloadFinished);
    connect(downloadVersionReply, QOverload<QNetworkReply::NetworkError>::of(&QNetworkReply::error), this, &program::downloadError);
}

void program::downloadError(QNetworkReply::NetworkError code)
{
    errorString = downloadVersionReply->errorString() + QString::number(downloadVersionReply->error());
    downloadVersionReply->abort();
    downloadVersionReply->deleteLater();
}

内容的提问来源于stack exchange，提问作者riverofwind