QT：Qt5 串口模块 (QSerialPort) 在 VS2015 中正确关闭串口避免被占用

以下是使用 Qt5 串口模块 (QSerialPort) 在 VS2015 中正确关闭串口避免被占用的完整示例代码：

#include <QSerialPort>
#include <QDebug>

// 创建全局或类成员变量（推荐使用智能指针）
QSerialPort *serialPort = nullptr; 

// 打开串口示例
void openSerialPort() {
    // 创建实例
    if (serialPort) {
        qDebug() << "Serial port already exists!";
        return;
    }
    serialPort = new QSerialPort();

    // 配置串口参数
    serialPort->setPortName("COM3"); // 你的串口号
    serialPort->setBaudRate(QSerialPort::Baud115200);
    serialPort->setDataBits(QSerialPort::Data8);
    serialPort->setParity(QSerialPort::NoParity);
    serialPort->setStopBits(QSerialPort::OneStop);

    // 尝试打开串口
    if (serialPort->open(QIODevice::ReadWrite)) {
        qDebug() << "Serial port opened successfully";
        
        // 连接数据接收信号槽
        connect(serialPort, &QSerialPort::readyRead, [=](){
            QByteArray data = serialPort->readAll();
            qDebug() << "Received:" << data;
        });
    } else {
        qDebug() << "Failed to open serial port:" << serialPort->errorString();
        // 打开失败时立即清理
        delete serialPort;
        serialPort = nullptr;
    }
}

// 正确关闭串口的核心步骤
void closeSerialPort() {
    if (serialPort) {
        // 1. 显式断开所有信号槽连接
        serialPort->disconnect();

        // 2. 停止数据流
        serialPort->clear(QSerialPort::AllDirections); 

        // 3. 关闭端口（关键步骤）
        serialPort->close();

        // 4. 立即释放资源（重要！）
        delete serialPort;
        serialPort = nullptr; // 防止野指针

        qDebug() << "Serial port closed and resources released";
    }
}

// 使用示例
int main() {
    openSerialPort();
    
    //... 进行调试操作
    
    closeSerialPort(); // 确保在退出前调用
    
    return 0;
}

关键点说明：

1. 资源释放三部曲：

   • disconnect(): 断开所有信号槽，避免残留回调
   • clear(): 清空缓冲区的未处理数据
   • close(): 系统级关闭端口（必须调用）

2. 内存管理：

   • 使用 delete 或 deleteLater() 彻底销毁对象
   • 将指针置空 (nullptr) 防止野指针

3. 错误预防：

   • 使用单例模式管理串口对象
   • 在打开失败时立即清理资源
   • 添加错误状态检查：

     if (serialPort->error() == QSerialPort::ResourceError) {
         qDebug() << "Critical error occurred, forcing cleanup";
         closeSerialPort();
     }
     

常见问题排查：

1. 如果仍提示占用，检查：

   • 是否在其他地方重复打开了同一端口
   • 是否忘记调用 closeSerialPort()
   • 是否有第三方程序占用（如串口调试助手）

2. 推荐使用 QScopedPointer 自动管理资源：

   QScopedPointer<QSerialPort> serialPort;
   serialPort.reset(new QSerialPort());
   // 退出作用域时自动调用 close() 和 delete
   

通过以上方法可确保串口资源被完全释放，避免出现占用问题。