QT C++串口读取时如何等待数据接收完成？

问题根源 #

发送读取命令后直接调用同步读取接口，此时串口还未返回完整数据，serialID为空或不完整，调用split(",")后得到的QStringList长度不足3，直接访问索引[2]触发Qt的断言错误（ASSERT failure in QList::operator[]: "index out of range"），导致程序崩溃。

解决方案：改用异步信号槽处理串口接收 #

Qt串口通信的正确姿势是用信号槽异步接收，避免同步阻塞等待导致的UI卡死和数据不完整问题。以下是具体修改方案：

1. 重构串口对象为类成员 #

将串口对象（推荐用Qt官方QSerialPort）声明为productDetail类的成员变量，避免每次点击按钮重复初始化：

// productDetail.h 中添加
#include <QSerialPort>
#include <QSerialPortInfo>

class productDetail : public QWidget
{
    Q_OBJECT

private:
    QSerialPort *serial; // 串口对象作为类成员
};

2. 在构造函数中初始化串口并连接信号槽 #

// productDetail.cpp 构造函数
productDetail::productDetail(QWidget *parent) : QWidget(parent), ui(new Ui::productDetail)
{
    ui->setupUi(this);
    serial = new QSerialPort(this);
    // 连接串口数据就绪信号到自定义槽函数
    connect(serial, &QSerialPort::readyRead, this, &productDetail::readSerialData);
}

3. 修改按钮点击事件：仅发送命令，不直接读取 #

void productDetail::on_pushButton_clicked()
{
    // 检查串口是否已打开，未打开则尝试打开第一个可用端口（可根据需求改成用户选择端口）
    if (!serial->isOpen()) {
        QList<QSerialPortInfo> portList = QSerialPortInfo::availablePorts();
        if (portList.isEmpty()) {
            qDebug() << "无可用串口";
            return;
        }
        // 配置串口参数
        serial->setPort(portList.first());
        serial->setBaudRate(QSerialPort::Baud9600);
        serial->setDataBits(QSerialPort::Data8);
        serial->setParity(QSerialPort::NoParity);
        serial->setStopBits(QSerialPort::OneStop);
        serial->setFlowControl(QSerialPort::NoFlowControl);
        
        if (!serial->open(QIODevice::ReadWrite)) {
            qDebug() << "串口打开失败：" << serial->errorString();
            return;
        }
        qDebug() << "串口已打开";
    }

    // 发送读取ID命令
    QString sendCmd = "WR+1121";
    serial->write(sendCmd.toUtf8());
    qDebug() << "已发送读取命令";
}

4. 实现数据接收槽函数：拼接数据+处理逻辑 #

串口返回的数据可能分多次到达，需要用静态缓冲区拼接，直到收到完整数据包（需根据你的串口协议确定结束标志，比如换行符\n或特定字符）：

void productDetail::readSerialData()
{
    QByteArray recvData = serial->readAll();
    static QString recvBuffer; // 静态缓冲区，保存未处理的部分数据
    recvBuffer += QString::fromUtf8(recvData);

    // 假设数据包以换行符结尾（需根据实际协议调整结束判断逻辑）
    if (recvBuffer.endsWith('\n')) {
        recvBuffer = recvBuffer.trimmed(); // 去除首尾空白（换行、空格等）
        QStringList dataParts = recvBuffer.split(",");
        
        // 必须先检查列表长度，避免索引越界
        if (dataParts.size() >= 3) {
            ui->IDlabel->setText(dataParts[2]);
        } else {
            qDebug() << "数据格式错误：" << recvBuffer;
        }
        recvBuffer.clear(); // 清空缓冲区，准备接收下一个数据包
    }
}

额外注意事项 #

• 端口选择：不要直接取最后一个枚举的端口，建议做一个下拉框让用户选择要使用的串口，避免选错。
• 协议适配：如果你的串口返回数据的结束标志不是换行，需要修改readSerialData中的结束判断逻辑（比如根据固定长度、特定结束符）。
• 错误处理：添加更多错误捕获逻辑（比如串口断开、数据校验等），提升程序稳定性。

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