使用QHttpMultiPart传输大文件时程序卡顿问题求助

核心问题排查 #

你的代码存在关键错误，直接导致大文件上传中断：

1. 主请求头的错误覆盖
   你给QNetworkRequest手动设置了Content-Type: multipart/form-data和Content-Disposition，但QHttpMultiPart作为post参数时，会自动生成包含boundary分隔符的正确Content-Type头，手动覆盖会丢失boundary信息，服务器无法识别多部分数据的分割点，接收第一个chunk后就无法继续解析后续内容。

2. 文件Part的ContentType设置错误
   文件部分的ContentTypeHeader被错误设置为multipart/form-data，正确的做法是设置文件对应的MIME类型（比如PDF用application/pdf，文本文件用text/plain），或留空让Qt自动推断。

3. 文件未显式以只读模式打开
   代码省略了文件打开逻辑，必须确保文件以QIODevice::ReadOnly模式打开，否则无法读取文件内容供上传使用。

修正后的代码示例 #

// Create multi-part
QHttpMultiPart* multiPart = new QHttpMultiPart(QHttpMultiPart::FormDataType);

// Open file
QFile* file = new QFile(myFilePath);
file->setParent(multiPart);
if (!file->open(QIODevice::ReadOnly)) {
    // 处理文件打开失败逻辑
    delete multiPart;
    return;
}

// Create file part
QHttpPart filePart;
// 修正：设置对应文件的MIME类型，此处以PDF为例，可根据文件类型动态调整
filePart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("application/pdf"));
filePart.setHeader(QNetworkRequest::ContentDispositionHeader,
                   QVariant(QString("form-data; name=\"file\"; filename=\"%1\"").arg(file->fileName())));
filePart.setBodyDevice(file);
// 可选：显式设置文件长度，帮助服务器判断接收进度
filePart.setHeader(QNetworkRequest::ContentLengthHeader, QVariant(file->size()));

// Add file part
multiPart->append(filePart);

// Setup request - 仅保留必要配置，移除错误的Content-Type和Content-Disposition
QNetworkRequest testRequest { myApiUrl };
// -- snip: Some SSL configuration --

// Send request
auto reply = m_networkAccessManager.post(testRequest, multiPart);
// 将multiPart的所有权转移给reply，请求完成后自动销毁，避免内存泄漏
multiPart->setParent(reply);
m_testReply.reset(reply);

额外注意事项 #

• 确保Qt事件循环正常运行（比如GUI程序中QApplication::exec()持续运行），否则QNetworkAccessManager无法处理异步上传的后续数据块。
• 针对100MB级超大文件，可通过QNetworkReply::uploadProgress监听上传进度，同时设置QNetworkRequest::TransferTimeoutHeader避免超时。
• 服务器端需支持流式解析multipart数据，避免一次性加载整个文件到内存导致阻塞。

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