QT SerialPort通过UART连接串口失败，提示设备未打开问题求助

问题描述 #

使用QT SerialPort通过UART连接串口，设备已正常连接（其他应用可正常使用该串口，且QSerialPortInfo能检测到它），但连接并读取时出现错误提示：QIODevice::read (QSerialPort): device not open。尝试在端口名前添加//./、\.\等前缀但无效。

原代码 #

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QDebug>


MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{

    ui->setupUi(this);
    m.setBaudRate(QSerialPort::Baud115200);
    m.setDataBits(QSerialPort::Data8);
    m.setPortName("COM2");
    m.setFlowControl(QSerialPort::NoFlowControl);
    m.setParity(QSerialPort::NoParity);
    m.setStopBits(QSerialPort::OneStop);
    m.setReadBufferSize(1000);
    qDebug()<<m.portName();
  while(1){
    qDebug()<<m.readAll();
  }
}

MainWindow::~MainWindow()
{
    delete ui;
}

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QSerialPort>

#include <QMainWindow>
#include <QSerialPortInfo>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

private:
    Ui::MainWindow *ui;
    QSerialPort m;
    QSerialPortInfo info;

};
#endif // MAINWINDOW_H

错误原因分析 #

1. 未调用open()方法打开串口：代码中仅配置了串口参数，但从未执行打开操作，直接调用readAll()必然报错设备未打开。
2. 死循环阻塞线程：构造函数中的while(1)会阻塞UI线程，不仅无法正常处理串口事件，还会导致程序界面无响应。

修正方案 #

核心修改点 #

• 添加串口打开逻辑并检查状态
• 用QT信号槽机制处理串口读取，替代死循环
• 确保程序退出时关闭串口

修正后的代码 #

mainwindow.h

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QSerialPort>
#include <QMainWindow>
#include <QSerialPortInfo>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

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

private slots:
    // 处理串口数据读取的槽函数
    void onSerialPortReadyRead();

private:
    Ui::MainWindow *ui;
    QSerialPort m_serialPort; // 重命名变量提升可读性
};
#endif // MAINWINDOW_H

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QDebug>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 配置串口参数
    m_serialPort.setBaudRate(QSerialPort::Baud115200);
    m_serialPort.setDataBits(QSerialPort::Data8);
    m_serialPort.setPortName("COM2");
    m_serialPort.setFlowControl(QSerialPort::NoFlowControl);
    m_serialPort.setParity(QSerialPort::NoParity);
    m_serialPort.setStopBits(QSerialPort::OneStop);
    m_serialPort.setReadBufferSize(1000);

    // 打开串口并检查状态
    if (!m_serialPort.open(QSerialPort::ReadWrite)) {
        qDebug() << "串口打开失败：" << m_serialPort.errorString();
        return;
    }
    qDebug() << "串口" << m_serialPort.portName() << "打开成功";

    // 连接信号槽：当串口有数据可读时触发读取
    connect(&m_serialPort, &QSerialPort::readyRead, this, &MainWindow::onSerialPortReadyRead);
}

MainWindow::~MainWindow()
{
    // 销毁前关闭串口
    if (m_serialPort.isOpen()) {
        m_serialPort.close();
    }
    delete ui;
}

void MainWindow::onSerialPortReadyRead()
{
    // 读取串口数据
    QByteArray data = m_serialPort.readAll();
    if (!data.isEmpty()) {
        qDebug() << "读取到数据：" << data;
    }
}

额外注意事项 #

• 端口名无需添加特殊前缀，直接使用QSerialPortInfo检测到的名称即可（比如"COM2"）。
• 若仍无法打开，可排查：
  • 串口是否被其他进程占用
  • 串口参数（波特率、数据位等）是否与设备完全匹配
  • Linux环境下程序是否加入dialout组以获取串口访问权限

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