Qt系统托盘应用无法接收WM_QUERYENDSESSION/WM_ENDSESSION消息排查

我是Qt新手，编写了如下代码来检测系统关机并执行清理操作：

class MyXcbEventFilter : public QAbstractNativeEventFilter {
public:
    MyXcbEventFilter():myWindow(Q_NULLPTR) {}
    void setMainWindow(QMainWindow* _mainWindow){ myWindow=_mainWindow; }
    virtual bool nativeEventFilter(const QByteArray &eventType, void *message, long *) Q_DECL_OVERRIDE {
        MSG * pMsg = static_cast<MSG *>(message);
        if (WM_ENDSESSION==pMsg->message||WM_QUERYENDSESSION==pMsg->message) {
            QSound::play(":/Sound/start.wav");
            if(myWindow!=Q_NULLPTR){
                myWindow->close();
            }
        }
        return false;
    }
private:
    QMainWindow* myWindow;
};

这段代码在应用窗口最大化时正常工作，但窗口最小化到系统托盘时就失效了。平台环境：Windows 10 64位、Qt 5.7.1、MSVC2015。

问题出在哪？ #

首先说个小细节：你的类名叫MyXcbEventFilter，但XCB是Linux平台的窗口系统接口，Windows下根本用不上，这名字有点误导人，但不是功能问题。

核心原因是：当窗口最小化到托盘后，主窗口处于不可见状态，Windows系统发送的WM_QUERYENDSESSION和WM_ENDSESSION消息没有被你的事件过滤器捕获——你的过滤器逻辑依赖主窗口指针，而窗口隐藏后，消息路由不再优先指向它，导致失效。另外，你直接强转MSG的写法虽然能工作，但没有绑定到应用全局的事件监听上，进一步加剧了消息漏抓的问题。

怎么解决？ #

给你两个实用方案，按需选择：

方案1：用Qt原生信号（推荐，跨平台）

Qt自带的QApplication::aboutToQuit()信号，不管窗口是最大化还是缩在托盘，只要应用要退出（包括系统关机触发的退出），这个信号都会触发。直接把清理逻辑绑到这个信号上就行，简单又靠谱：

// 可以在主窗口构造函数或main函数初始化时添加
connect(qApp, &QApplication::aboutToQuit, [this](){
    QSound::play(":/Sound/start.wav");
    if(myWindow != Q_NULLPTR){
        myWindow->close();
    }
    // 这里还能加其他清理操作，比如保存配置、关闭文件等
});

这个方式不需要碰原生事件，跨平台性拉满，以后移植到Linux或Mac也不用改代码。

方案2：修正原生事件过滤器（Windows专用）

如果你一定要用原生事件的方式，那得把过滤器绑定到QApplication上，确保全局捕获消息，不再依赖单个窗口：

// 重写事件过滤器类，改成Windows专用版本
class MyWindowsEventFilter : public QAbstractNativeEventFilter {
public:
    bool nativeEventFilter(const QByteArray &eventType, void *message, long *result) override {
        // 先判断是不是Windows的MSG消息
        if (eventType == "windows_generic_MSG") {
            MSG *pMsg = static_cast<MSG*>(message);
            if (pMsg->message == WM_QUERYENDSESSION || pMsg->message == WM_ENDSESSION) {
                QSound::play(":/Sound/start.wav");
                // 执行清理逻辑
                qApp->quit(); // 主动触发应用退出，也会同步触发aboutToQuit信号
                *result = 0; // 告诉系统我们已处理完消息
                return true; // 返回true表示拦截并处理了该消息
            }
        }
        return false; // 其他消息交给Qt默认处理
    }
};

然后在main函数里安装这个全局过滤器：

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    
    MyWindowsEventFilter systemShutdownFilter;
    a.installNativeEventFilter(&systemShutdownFilter);
    
    MainWindow w;
    w.show();
    
    return a.exec();
}

这样修改后，不管窗口在不在托盘，应用都能捕获到系统关机的消息，因为过滤器是全局安装在QApplication上的，不依赖单个窗口的状态。

额外小提示 #

• WM_QUERYENDSESSION是系统关机前的询问：“你能不能退出？”，返回允许后系统才会继续流程；WM_ENDSESSION是系统通知：“马上要关机了，快收尾”，这时候得尽快完成清理，别做耗时操作。
• 优先选方案1，Qt原生信号就是为这种场景设计的，省心又不容易踩坑。

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