QNetworkAccessManager上传文件必须使用QHttpMultiPart构造multipart/form-data请求体，不能直接用QNetworkRequest发送原始POST数据；需设置QHttpMultiPart类型为FormDataType，各字段（文本/文件）作为QHttpPart添加，文件用setBodyFromDevice()并保持QFile打开至上传完成，且须手动管理对象生命周期以防内存泄漏或中断。
QNetworkAccessManager上传文件必须用QHttpMultiPart
直接用QNetworkRequest发POST请求体是不行的——它不支持multipart/form-data编码，而文件上传必须用这种格式。你得用QHttpMultiPart组装整个请求体，再交给QNetworkAccessManager发出去。
常见错误是试图把文件读成QByteArray后塞进QNetworkRequest::setRawHeader()或直接当postData传，结果服务端收不到文件字段，或者解析出错（比如返回400 Bad Request或空文件）。
-
QHttpMultiPart类型必须设为QHttpMultiPart::FormDataType，不能用RelatedType或MixedType - 每个文件字段要封装成
QHttpPart，用setBodyFromDevice()传QFile*指针（别用setBody()，否则内存拷贝大文件会卡死） -
QFile必须在QNetworkReply完成前保持打开状态，否则上传中途读取失败
上传时如何带额外参数和多个文件
表单里的文本字段（如filename、token）和文件字段是平级的，都作为QHttpPart添加到同一个QHttpMultiPart里。多个文件就加多个QHttpPart，顺序无关，但注意字段名要和服务端约定一致。
示例场景：上传一个图片+一个描述文本+一个可选日志文件：
立即学习“C++免费学习笔记（深入）”；
QHttpMultiPart *multiPart = new QHttpMultiPart(QHttpMultiPart::FormDataType);
// 文本字段
QHttpPart textPart;
textPart.setHeader(QNetworkRequest::ContentDispositionHeader,
QVariant("form-data; name=\"description\""));
textPart.setBody("my photo");
multiPart->append(textPart);
// 主文件
QHttpPart filePart;
filePart.setHeader(QNetworkRequest::ContentTypeHeader, QVariant("image/jpeg"));
filePart.setHeader(QNetworkRequest::ContentDispositionHeader,
QVariant("form-data; name=\"image\"; filename=\"photo.jpg\""));
QFile *file = new QFile("/path/to/photo.jpg");
file->open(QIODevice::ReadOnly);
filePart.setBodyFromDevice(file);
multiPart->append(filePart);
// 可选日志文件（检查是否存在再加）
QFile *logFile = new QFile("/tmp/upload.log");
if (logFile->exists()) {
logFile->open(QIODevice::ReadOnly);
QHttpPart logPart;
logPart.setHeader(QNetworkRequest::ContentDispositionHeader,
QVariant("form-data; name=\"log\"; filename=\"upload.log\""));
logPart.setBodyFromDevice(logFile);
multiPart->append(logPart);
}
必须手动管理QHttpMultiPart和QFile的生命周期
QNetworkAccessManager::post()不会接管QHttpMultiPart的所有权——你得自己在QNetworkReply::finished()信号里清理它，否则内存泄漏；更关键的是，QFile也不能提前关闭或析构，否则上传会中断并返回QNetworkReply::OperationCanceledError。
典型写法是把QHttpMultiPart*和所有QFile*存为成员变量，或用QObject::setParent()绑定到reply上：
- 调用
post()后，立即对QNetworkReply*调用setParent(multiPart)，这样reply销毁时会自动删multiPart - 每个
QFile*也设为multiPart的子对象：file->setParent(multiPart) - 不要在
connect(reply, &QNetworkReply::finished, ...)回调里直接deleteLater()这些对象——让parent关系自动处理
上传失败时怎么定位是网络问题还是服务端问题
看QNetworkReply::error()返回值：QNetworkReply::NoError不代表成功，只是网络层通了；真正要检查的是HTTP状态码（reply->attribute(QNetworkRequest::HttpStatusCodeAttribute)）和响应体内容。
常见组合：
-
reply->error() == QNetworkReply::OperationCanceledError→ 文件被提前关闭，或QHttpMultiPart被删了 -
reply->error() == QNetworkReply::ContentAccessDenied→ 服务端返回403，可能缺token或权限不足 -
reply->error() == QNetworkReply::UnknownNetworkError且状态码是400→ 很可能是multipart格式不对（比如Content-Disposition头漏了name=，或filename没加引号） - 收到
200但响应体是{"success":false,"msg":"invalid file"}→ 文件内容或类型被服务端拒绝，不是Qt的问题
调试建议：用Wireshark或Fiddler抓包，对比浏览器上传时的原始请求头和body结构，尤其注意boundary是否一致、每段part的header换行是否是\r\n。
