Qt多线程通讯中信号阻塞问题及解决方案

创作时间:

作者:

@小白创作中心

Qt多线程通讯中信号阻塞问题及解决方案

引用

CSDN

https://blog.csdn.net/chenai886/article/details/141959907

在多线程应用中，串口通讯或TCP通讯的场景常常涉及到持续的读写操作，如果子线程处理不当，可能会导致信号阻塞问题。本文将通过串口通讯或TCP通讯为例，详细解释如何在多线程环境中避免信号阻塞，并提供代码示例。

1. 问题背景

假设我们在一个应用程序中使用多线程处理串口或TCP通讯，通常会在子线程中实现持续的数据读取。为了确保实时处理数据，常见的做法是在子线程的 run() 方法中使用 while 循环。然而，如果没有正确处理事件循环，子线程可能会出现无法接收信号或阻塞的现象。

串口或TCP通讯的基本结构

通常，串口或TCP通讯的流程如下：

子线程负责监听串口或TCP端口，接收数据。
主线程通过信号槽机制向子线程发送控制命令。
子线程接收到命令后执行相应操作，并将结果通过信号传回主线程。

2. 常见信号阻塞现象

在没有处理事件循环的情况下，子线程执行如下代码：

示例：阻塞信号的串口通讯

class SerialThread : public QThread {
    Q_OBJECT
public:
    SerialThread(QObject *parent = nullptr) : QThread(parent) {
        connect(this, &SerialThread::dataReceived, this, &SerialThread::handleData);
    }
    void run() override {
        QSerialPort serial;
        serial.setPortName("COM1");
        serial.setBaudRate(QSerialPort::Baud115200);
        if (!serial.open(QIODevice::ReadWrite)) {
            qDebug() << "Failed to open serial port!";
            return;
        }
        while (true) {
            if (serial.waitForReadyRead(1000)) {
                QByteArray data = serial.readAll();
                emit dataReceived(data); // 发出数据接收信号
            }
        }
    }
signals:
    void dataReceived(const QByteArray &data);
private slots:
    void handleData(const QByteArray &data) {
        qDebug() << "Data received in thread:" << data;
    }
};

问题分析：

在上述代码中，子线程通过 while 循环不断监听串口数据，数据到达时发出 dataReceived 信号。然而，由于线程在 while 循环中没有进入事件循环，其他信号（例如来自主线程的控制命令）可能无法被处理，导致信号阻塞。

示例：阻塞信号的TCP通讯

class TcpThread : public QThread {
    Q_OBJECT
public:
    TcpThread(QObject *parent = nullptr) : QThread(parent) {
        connect(this, &TcpThread::messageReceived, this, &TcpThread::handleMessage);
    }
    void run() override {
        QTcpSocket socket;
        socket.connectToHost("127.0.0.1", 8080);
        if (!socket.waitForConnected(3000)) {
            qDebug() << "Failed to connect!";
            return;
        }
        while (true) {
            if (socket.waitForReadyRead(1000)) {
                QString message = socket.readAll();
                emit messageReceived(message); // 发出消息接收信号
            }
        }
    }
signals:
    void messageReceived(const QString &message);
private slots:
    void handleMessage(const QString &message) {
        qDebug() << "Message received in thread:" << message;
    }
};

这里的问题与串口通讯类似，while 循环导致线程无法进入事件循环，可能会阻塞信号的处理。

3. 使用 `QEventLoop` 解决信号阻塞问题

为了避免信号阻塞，我们可以在 while 循环中使用 QEventLoop。这种方式确保了线程在执行任务的同时，仍然能够处理来自其他对象的信号。

示例：使用 `QEventLoop` 的串口通讯

class SerialThread : public QThread {
    Q_OBJECT
public:
    SerialThread(QObject *parent = nullptr) : QThread(parent) {
        connect(this, &SerialThread::dataReceived, this, &SerialThread::handleData);
    }
    void run() override {
        QSerialPort serial;
        serial.setPortName("COM1");
        serial.setBaudRate(QSerialPort::Baud115200);
        if (!serial.open(QIODevice::ReadWrite)) {
            qDebug() << "Failed to open serial port!";
            return;
        }
        QEventLoop eventLoop;
        while (true) {
            if (serial.waitForReadyRead(1000)) {
                QByteArray data = serial.readAll();
                emit dataReceived(data); // 发出信号
            }
            QTimer::singleShot(10, &eventLoop, &QEventLoop::quit);
            eventLoop.exec();  // 进入事件循环以处理信号
        }
    }
signals:
    void dataReceived(const QByteArray &data);
private slots:
    void handleData(const QByteArray &data) {
        qDebug() << "Data received in thread:" << data;
    }
};

示例：使用 `QEventLoop` 的TCP通讯

class TcpThread : public QThread {
    Q_OBJECT
public:
    TcpThread(QObject *parent = nullptr) : QThread(parent) {
        connect(this, &TcpThread::messageReceived, this, &TcpThread::handleMessage);
    }
    void run() override {
        QTcpSocket socket;
        socket.connectToHost("127.0.0.1", 8080);
        if (!socket.waitForConnected(3000)) {
            qDebug() << "Failed to connect!";
            return;
        }
        QEventLoop eventLoop;
        while (true) {
            if (socket.waitForReadyRead(1000)) {
                QString message = socket.readAll();
                emit messageReceived(message); // 发出信号
            }
            QTimer::singleShot(10, &eventLoop, &QEventLoop::quit);
            eventLoop.exec(); // 进入事件循环以处理信号
        }
    }
signals:
    void messageReceived(const QString &message);
private slots:
    void handleMessage(const QString &message) {
        qDebug() << "Message received in thread:" << message;
    }
};