QSerialPort从ComboBox选择端口后端口名未成功设置的技术求助

首先看你遇到的核心问题：调试输出里mSerialPort->portName()是空字符串，这是因为构造函数里设置端口名的时机不对——你在给ComboBox添加任何选项之前，就调用了mSerialPort->setPortName(ui->comboBox->currentText());，这时候ComboBox还没有选项，currentText()自然是空的，导致串口的端口名没被正确设置。

另外你的连接按钮点击事件里还有几个逻辑错误，我一起帮你梳理并修正：

问题1：构造函数中设置端口名的时机错误 #

你在构造函数里的执行顺序是：

mSerialPort = new QSerialPort(this);
mSerialPort->setPortName(ui->comboBox->currentText()); // 这里ComboBox还没加选项，currentText是空
// ...其他串口配置
// 然后才给ComboBox加选项
ui->comboBox->addItem("COM6");
// ...其他COM口

这时候设置的端口名是空字符串，后续如果不重新设置，串口一直用的是空端口名。

问题2：连接按钮的逻辑错误 #

1. 你先调用mSerialPort->open(QIODevice::ReadWrite);，但这时候端口名可能不对，打开大概率会失败；
2. mSerialPort->isOpen是成员函数，应该写成mSerialPort->isOpen()；
3. 遍历可用端口的逻辑有问题：如果当前遍历的不是COM6，就直接弹出错误提示，这会导致只要有一个可用端口不是COM6，就触发错误，而不是只有当COM6不存在时才提示。

修正后的完整代码 #

构造函数部分 #

调整执行顺序，先给ComboBox添加选项，再设置默认端口名，同时添加ComboBox选择变化的信号连接，实时更新端口名：

Widget::Widget(QWidget *parent) : QWidget(parent) , ui(new Ui::Widget) {
    qmlRegisterType<FileIO>("FileIO",1,0,"FileIO"); //用于QML读取CSV的QObject类
    ui->setupUi(this);
    setupPlots();
    setWindowTitle("GUI");
    
    // 先初始化ComboBox选项
    ui->comboBox->addItem("COM6");
    ui->comboBox->addItem("COM5");
    ui->comboBox->addItem("COM4");
    ui->comboBox->addItem("COM3");
    ui->comboBox->addItem("COM2");
    ui->comboBox->addItem("COM1");

    //串口通信相关QSerialPort配置
    mSerialPort = new QSerialPort(this);
    // 现在ComboBox有选项了，设置默认端口名
    mSerialPort->setPortName(ui->comboBox->currentText());
    mSerialPort->setBaudRate(QSerialPort::Baud9600);
    mSerialPort->setDataBits(QSerialPort::Data8);
    mSerialPort->setParity(QSerialPort::NoParity);
    mSerialPort->setStopBits(QSerialPort::OneStop);
    mSerialPort->setFlowControl(QSerialPort::NoFlowControl);
    connect(mSerialPort, SIGNAL(readyRead()), this, SLOT(readSerialData()));
    
    // 实时更新端口名：当用户切换ComboBox选项时，自动更新串口端口名
    connect(ui->comboBox, &QComboBox::currentTextChanged, this, [this](const QString &portName){
        if(mSerialPort->isOpen()){
            mSerialPort->close();
        }
        mSerialPort->setPortName(portName);
    });

    //旋转控件相关QQuickWidget配置
    ui->quickWidget->setSource(QUrl("qrc:/main.qml"));
    ui->quickWidget->show();
}

连接按钮点击事件修正 #

void Widget::on_connectButton_clicked() {
    // 先检查串口是否已经打开
    if(mSerialPort->isOpen()){
        QMessageBox::information(this, tr("提示"), "串口已经处于连接状态");
        return;
    }

    // 获取当前选择的端口名
    QString targetPort = ui->comboBox->currentText();
    // 先检查目标端口是否存在于可用端口中
    bool portExists = false;
    foreach (QSerialPortInfo item, QSerialPortInfo::availablePorts()) {
        if(item.portName() == targetPort){
            portExists = true;
            mSerialPort->setPort(item);
            break;
        }
    }

    if(!portExists){
        QMessageBox::critical(this, tr("错误"), QString("端口%1不存在或未连接").arg(targetPort));
        qDebug() << "可用端口列表:";
        foreach (QSerialPortInfo item, QSerialPortInfo::availablePorts()) {
            qDebug() << item.portName();
        }
        return;
    }

    // 尝试打开串口
    if(mSerialPort->open(QIODevice::ReadWrite)){
        QMessageBox::information(this, tr("connected"), "serial communication started");
        ui->label_2->setText("Continuing");
    } else {
        QMessageBox::critical(this, tr("failed"), mSerialPort->errorString());
    }
}

断开连接按钮优化 #

可以加个判断，避免重复关闭串口的无效操作：

void Widget::on_disconnectButton_clicked(){
    if(mSerialPort->isOpen()){
        mSerialPort->close();
        QMessageBox::information(this, tr("disconnected"), "serial communication finished");
        ui->label_2->setText("Stopped");
    } else {
        QMessageBox::information(this, tr("提示"), "串口已经处于断开状态");
    }
}

这样调整后，就能解决你遇到的端口名为空的问题，同时让串口连接的逻辑更健壮，避免不必要的错误提示。

内容的提问来源于stack exchange，提问作者Lady Be Good