Qt TCP/IP传输图片时分包接收问题及解决方法咨询

这个问题的核心原因很好理解：TCP是流式传输协议，它不保证数据会一次性完整到达。本地测试时因为网络延迟极低、数据路径短，图片数据大概率会一次性发送到客户端，但跨以太网传输时，TCP会根据网络MTU（最大传输单元）拆分数据，IP层也可能分片，这就导致客户端的readyRead()信号会多次触发，每次只能拿到部分图片数据。你当前的代码每次触发readyRead()就直接尝试解析图片，自然会因为数据不完整加载失败。

要解决这个问题，我们需要给传输的图片数据加上消息边界标识，最常用的方式就是先发送图片数据的总长度，客户端先接收这个长度值，然后持续接收数据直到拿到足够长度的字节，再进行图片解析。

修改后的服务端代码 #

void server::writePic(QString fileName) { 
    name = QString("%1.png").arg(counter); 
    counter++; 
    qDebug() << name; 

    pic.load(fileName, "PNG"); 
    pic.setText("name",name); 
    pic.setText("datum","20-3-2018"); 

    QByteArray ba; 
    QBuffer buffer(&ba); 
    pic.save(&buffer, "PNG"); 

    // 第一步：发送图片数据的总长度（用qint64保证能容纳大文件）
    qint64 dataSize = ba.size();
    QByteArray sizeBytes;
    QDataStream sizeStream(&sizeBytes, QIODevice::WriteOnly);
    sizeStream.setVersion(QDataStream::Qt_5_15); // 保持和客户端版本一致
    sizeStream << dataSize;

    socket->write(sizeBytes);
    socket->waitForBytesWritten();

    // 第二步：发送实际的图片数据
    socket->write(ba); 
    socket->waitForBytesWritten();
    socket->flush(); 
}

修改后的客户端代码 #

// 先在Client类中添加成员变量，用来保存待接收的数据和目标长度
private:
    QByteArray m_receivedData;
    qint64 m_expectedSize = 0;

// 然后修改readyRead槽函数
void Client::readyRead() {
    // 如果还没获取到数据长度，先处理长度
    if (m_expectedSize == 0) {
        // 至少需要拿到qint64的字节数（8字节）
        if (socket->bytesAvailable() < sizeof(qint64)) {
            return;
        }

        QByteArray sizeBytes = socket->read(sizeof(qint64));
        QDataStream sizeStream(&sizeBytes, QIODevice::ReadOnly);
        sizeStream.setVersion(QDataStream::Qt_5_15);
        sizeStream >> m_expectedSize;
    }

    // 接收图片数据，直到达到预期长度
    while (socket->bytesAvailable() > 0) {
        m_receivedData.append(socket->readAll());
        if (m_receivedData.size() >= m_expectedSize) {
            // 数据接收完整，开始解析图片
            QImage pic;
            if (pic.loadFromData(m_receivedData)) {
                qDebug() << "Image file was received ";
                qDebug() << pic.text("name");
                qDebug() << pic.text("datum");
                qDebug() << "size = " << m_receivedData.size();

                std::stringstream fileName;
                fileName << "C:/pics/" << pic.text("name").toStdString();
                pic.save(fileName.str().c_str(),"PNG");
            } else {
                qDebug() << "Pic is NULL";
                qDebug() << "size = " << m_receivedData.size();
            }

            // 重置状态，准备接收下一张图片
            m_receivedData.clear();
            m_expectedSize = 0;
            break;
        }
    }
}

关键细节说明 #

1. 数据长度的传输：用QDataStream来序列化长度值，避免字节序问题（跨平台传输时尤其重要），要保证客户端和服务端的QDataStream版本一致。
2. 状态管理：客户端通过成员变量跟踪当前是否在接收长度、已接收的数据量和目标长度，确保只有当数据完全接收后才进行解析。
3. 循环接收：在readyRead()中使用循环处理剩余数据，避免因为一次信号触发只拿到部分数据而等待下一次信号。

这样修改后，不管网络如何拆分数据，客户端都能完整接收整张图片的数据，再进行加载和保存，就不会出现pic.isNull()的问题了。

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