Qt Creator中如何追踪非GUI事件？非GUI类COM端口更新无限循环检测导致应用崩溃，QThread未解决问题

一、解决COM端口检测导致程序崩溃的问题 #

你的代码核心问题出在线程的启动方式错误，直接调用QThread的run()方法会让无限循环在主线程执行，阻塞Qt的事件循环（a.exec()），最终导致UI冻结甚至崩溃。下面是具体修复和优化方案：

1. 修正线程启动逻辑 #

在main.cpp中，把直接调用run()的代码改成调用start()——这才是启动QThread的正确方式，它会创建独立的操作系统线程执行run()中的逻辑：

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    MainWindow w;
    checkPorts ports;
    w.show();
    ports.start(); // 替换ports.run()
    return a.exec();
}

2. 优化线程类的实现 #

你的checkPorts类还有几个需要完善的点：缺少线程退出条件、头文件结构不规范、端口检测过于频繁。修改后的代码如下：

CheckPortsThread.h

#ifndef CHECKPORTSTHREAD_H
#define CHECKPORTSTHREAD_H
#include <QtCore>
class checkPorts: public QThread{
    Q_OBJECT // 必须添加Q_OBJECT宏才能使用Qt的信号槽机制
public:
    checkPorts(QObject *parent = nullptr);
    void run() override;
    void stop(); // 添加线程停止方法，用于优雅退出
private:
    bool m_isRunning; // 标记线程是否继续运行
};
#endif // CHECKPORTSTHREAD_H

CheckPortsThread.cpp

#include "CheckPortsThread.h"
#include <QSerialPortInfo>

checkPorts::checkPorts(QObject *parent) : QThread(parent), m_isRunning(true) {}

void checkPorts::run(){
    while (m_isRunning){
        // 检测当前可用COM端口
        QList<QSerialPortInfo> availablePorts = QSerialPortInfo::availablePorts();
        qDebug() << "当前可用端口数量：" << availablePorts.size();
        for(const auto& port : availablePorts){
            qDebug() << "端口名：" << port.portName() << " | 设备描述：" << port.description();
        }
        // 每隔1秒检测一次，避免过度占用CPU资源
        QThread::sleep(1);
    }
}

void checkPorts::stop(){
    m_isRunning = false;
    wait(); // 等待线程完全退出后再销毁
}

3. 管理线程生命周期 #

为了避免内存泄漏，建议在MainWindow中管理线程的创建和停止：
在MainWindow.h中添加成员变量：

private:
    checkPorts* m_portChecker;

在MainWindow.cpp的构造函数和析构函数中补充逻辑：

MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow),
    m_portChecker(new checkPorts(this))
{
    ui->setupUi(this);
    // ... 原有初始化代码
    m_portChecker->start(); // 启动端口检测线程
}

MainWindow::~MainWindow() {
    m_portChecker->stop(); // 关闭窗口时停止线程
    delete ui;
}

二、在Qt Creator中追踪非GUI事件 #

想要追踪Qt中的非GUI事件（比如线程事件、定时器事件、自定义事件等），可以尝试以下几种方法：

• 用QDebug输出事件信息：在事件处理函数或自定义逻辑中，直接打印事件类型、来源等信息。比如重写QObject::event()方法：

bool MyNonGuiClass::event(QEvent *event) {
    qDebug() << "收到事件类型：" << event->type();
    return QObject::event(event);
}

• 利用Qt Creator调试器：

  1. 在调试模式下，给QCoreApplication::notify()设置断点——这是Qt所有事件的分发入口
  2. 触发事件后，调试器会自动暂停，你可以查看事件的详细参数和调用栈

• 自定义事件过滤器：通过installEventFilter()给目标对象安装过滤器，拦截并监控所有事件：

class EventMonitor : public QObject {
    Q_OBJECT
protected:
    bool eventFilter(QObject *watched, QEvent *event) override {
        qDebug() << watched->objectName() << "触发事件：" << event->type();
        return QObject::eventFilter(watched, event);
    }
};

// 使用示例
EventMonitor* monitor = new EventMonitor(this);
myNonGuiObject->installEventFilter(monitor);

• 启用Qt事件日志：在Qt Creator的「项目」设置中，添加环境变量QT_EVENT_TRACE=1，程序运行时会在控制台输出所有事件的追踪信息。

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