Qt/C++无法提交文本参数及上传文件问题排查

你的代码存在几个关键问题，导致服务器无法正确解析请求中的文本参数和文件内容，以下是具体问题说明及修复方案：

1. 手动指定Boundary导致不匹配 #

你手动设置了Content-Type头中的boundary，但QHttpMultiPart会自动生成唯一的boundary值，手动指定的boundary和实际请求使用的不一致，服务器无法正确分割表单字段。必须删除手动设置的Content-Type头，QNetworkAccessManager会自动根据QHttpMultiPart生成正确的multipart/form-data请求头。

2. QNetworkAccessManager为局部变量 #

QNetworkAccessManager manager是函数内的局部变量，函数执行完毕后会被销毁，导致请求未完成就被中断。需要将其改为类成员变量，或用智能指针延长生命周期。

3. 文件打开未做错误检查 #

直接调用file->open(QIODevice::ReadOnly)后未检查是否成功，若文件不存在或权限不足，会导致文件内容无法发送，必须添加错误判断。

4. Filename包含完整路径 #

你直接将完整路径archive作为filename传入，服务器可能无法正确识别文件名，应该提取纯文件名部分。

修复后的完整代码 #

// 注意：先将manager改为类成员变量，比如在类头文件中声明：QNetworkAccessManager *m_manager;
// 在类构造函数中初始化：m_manager = new QNetworkAccessManager(this);

void UploadPatch(QString archive)
{
    qInfo() << "Upload procedure started! This could take a while, please wait....";
    QUrl url("https://www.test.test/api/upload/newVersion");
    QNetworkRequest request(url);

    #ifdef DEVELOPMENT_ENV
        QSslConfiguration sslConfig = request.sslConfiguration();
        sslConfig.setPeerVerifyMode(QSslSocket::VerifyNone);
        sslConfig.setProtocol(QSsl::TlsV1_2); // 根据需要调整协议
        request.setSslConfiguration(sslConfig);
    #endif

    // 移除手动设置的Content-Type头，QHttpMultiPart会自动处理
    request.setRawHeader("accept", "application/json");
    request.setRawHeader("Authorization", "Bearer TOKEN_HERE");

    // 构建multipart请求
    QHttpMultiPart *multiPart = new QHttpMultiPart(QHttpMultiPart::FormDataType);

    // 添加文本参数
    QStringList params = {"os", "major", "minor", "patch", "build"};
    QStringList values = {"mac", "2", "2", "2", "100"};

    for (int i = 0; i < params.size(); ++i) {
        QHttpPart textPart;
        textPart.setHeader(QNetworkRequest::ContentDispositionHeader, 
                          QVariant("form-data; name=\"" + params[i] + "\""));
        textPart.setBody(values[i].toUtf8());
        multiPart->append(textPart);
    }

    // 添加文件参数
    QHttpPart filePart;
    filePart.setHeader(QNetworkRequest::ContentTypeHeader, "application/octet-stream");
    // 提取纯文件名，去掉路径
    QString fileName = QFileInfo(archive).fileName();
    filePart.setHeader(QNetworkRequest::ContentDispositionHeader, 
                      QVariant("form-data; name=\"updateFile\"; filename=\"" + fileName + "\""));
    QFile *file = new QFile(archive);
    if (!file->open(QIODevice::ReadOnly)) {
        qDebug() << "文件打开失败:" << file->errorString();
        delete file;
        delete multiPart;
        return;
    }
    filePart.setBodyDevice(file);
    file->setParent(multiPart);  // 确保文件对象被正确销毁
    multiPart->append(filePart);

    // 发送请求
    QNetworkReply *reply = m_manager->post(request, multiPart);
    multiPart->setParent(reply);  // 确保multipart对象被正确销毁

    QObject::connect(reply, &QNetworkReply::finished,  [=]() {
        qDebug() << "响应头:" << reply->rawHeaderPairs();
        if (reply->error() != QNetworkReply::NoError) {
            qDebug() << "网络错误:" << reply->errorString();
        }
        UploadResult(reply);
        reply->deleteLater(); // 确保reply被正确销毁
    });
}

额外调试建议 #

• 启用Qt网络调试输出，对比实际发送的请求与Postman请求的差异：

  qputenv("QT_LOGGING_RULES", "qt.network.ssl.debug=true;qt.network.request.debug=true");
  

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