QT C++如何检测QSerialPort设备拔出并自动关闭串口？

问题原因 #

当串口处于打开状态时，即使USB设备拔出，系统可能仍保留该串口的缓存信息，导致getAvailiblePorts()返回非空结果，且串口连接不会自动断开。需要通过监听串口错误信号+定期校验状态的组合方式，实现设备拔出时自动关闭串口。

解决方案 #

1. 监听串口错误信号 #

QSerialPort提供errorOccurred信号，当设备被意外移除时，会触发SerialPortError::ResourceError错误，此时可在槽函数中直接关闭串口。

2. 定期校验串口状态 #

通过定时器周期性检查当前打开的串口是否还存在于可用设备列表中，若不存在则手动关闭串口，作为错误信号监听的补充。

完整示例代码 #

头文件（MainWindow.h）

#include <QMainWindow>
#include <QSerialPort>
#include <QSerialPortInfo>
#include <QTimer>

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void on_pushButton_clicked();
    void handleSerialError(QSerialPort::SerialPortError error);
    void checkSerialPortStatus();

private:
    QSerialPort m_serial;
    QTimer* m_checkTimer;
};

源文件（MainWindow.cpp）

#include "MainWindow.h"
#include <QDebug>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
{
    // 绑定串口错误信号
    connect(&m_serial, &QSerialPort::errorOccurred, this, &MainWindow::handleSerialError);

    // 初始化定时器，每秒检查一次串口状态
    m_checkTimer = new QTimer(this);
    connect(m_checkTimer, &QTimer::timeout, this, &MainWindow::checkSerialPortStatus);
    m_checkTimer->start(1000);
}

MainWindow::~MainWindow()
{
    if (m_serial.isOpen()) {
        m_serial.close();
    }
}

void MainWindow::on_pushButton_clicked()
{
    QList<QSerialPortInfo> availablePorts = QSerialPortInfo::availablePorts();
    if(availablePorts.isEmpty()){
        qDebug()<<"Empty";
    }
    else
    {
        qDebug()<<"Not Empty";
        // 示例：打开第一个可用串口
        if (!m_serial.isOpen()) {
            m_serial.setPort(availablePorts.first());
            if (m_serial.open(QIODevice::ReadWrite)) {
                qDebug() << "串口已打开:" << m_serial.portName();
            } else {
                qDebug() << "打开串口失败:" << m_serial.errorString();
            }
        }
    }
}

void MainWindow::handleSerialError(QSerialPort::SerialPortError error)
{
    // 设备被移除时触发ResourceError
    if (error == QSerialPort::ResourceError) {
        qDebug() << "串口设备已断开，正在关闭串口...";
        m_serial.close();
    }
}

void MainWindow::checkSerialPortStatus()
{
    if (m_serial.isOpen()) {
        bool portExists = false;
        QList<QSerialPortInfo> availablePorts = QSerialPortInfo::availablePorts();
        // 校验当前打开的串口是否仍在可用列表中
        for (const QSerialPortInfo& info : availablePorts) {
            if (info.portName() == m_serial.portName() && info.systemLocation() == m_serial.systemLocation()) {
                portExists = true;
                break;
            }
        }
        if (!portExists) {
            qDebug() << "未找到已打开的串口，正在关闭...";
            m_serial.close();
        }
    }
}

说明 #

• 错误信号监听是最直接的响应方式，能快速捕获设备移除事件；
• 定期校验作为补充，避免某些极端场景下错误信号未触发的遗漏；
• 串口关闭后，getAvailiblePorts()会返回正确的空列表。

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