Qt程序读取数据库时Windows Hook失效问题求助

这个问题的核心在于低级别键盘钩子（WH_KEYBOARD_LL）的工作机制：它的回调函数并不是在独立线程中执行，而是依赖于调用SetWindowsHookEx的线程（也就是你的主线程）的消息循环来处理钩子事件。如果主线程被长时间阻塞（比如启动时的数据库读取操作），Windows系统会认为钩子线程无响应，从而自动卸载钩子——尤其是你在启动时持续按键，钩子需要频繁触发，消息队列堆积，系统就会更快放弃这个钩子。

而直接给pressedTimes赋值不会触发这个问题，是因为赋值操作几乎不耗时，主线程消息循环能立刻处理钩子回调；但Access数据库的ODBC读取操作（哪怕看起来很快）可能涉及驱动初始化、文件IO等耗时步骤，刚好阻塞了主线程的消息循环。

解决方案：把数据库初始化移到后台线程 #

我们需要把耗时的数据库读取操作从主线程剥离，让主线程专注处理钩子的消息回调。这里用Qt的QtConcurrent来实现后台线程，非常简洁：

1. 修改Widget类，添加信号用于接收后台线程的初始化结果

在widget.h中添加一个信号：

class Widget : public QWidget {
    Q_OBJECT
    // ... 已有的成员变量和函数
signals:
    void initPressedTimesCompleted(int totalCount);
};

2. 调整Widget构造函数的执行顺序

先设置钩子，再启动后台线程处理数据库读取，避免阻塞主线程：

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

    // 优先设置钩子，确保主线程消息循环能处理钩子事件
    hHook = SetWindowsHookEx(WH_KEYBOARD_LL, MyLowLevelKeyBoardProc, NULL, 0);
    if (!hHook) {
        qDebug() << "钩子设置失败，错误码：" << GetLastError();
    }

    // 连接信号，接收后台返回的初始化值并更新UI
    connect(this, &Widget::initPressedTimesCompleted, this, [this](int total) {
        pressedTimes = total;
        ui->label->setText(QString::number(pressedTimes));
    });

    // 启动后台线程执行数据库读取
    QtConcurrent::run([this]() {
        // 注意：QSqlDatabase不能跨线程共享，所以在后台线程创建Database实例
        Database db;
        int total = db.returnTotalPressedTimes();
        // 发送信号到主线程更新UI
        emit initPressedTimesCompleted(total);
    });

    // 按键信号的连接保持不变
    connect(Emitter::Instance(), &SignalEmitter::keyPressed, [this](){
        pressedTimes++;
        ui->label->setText(QString::number(pressedTimes));
    });
}

3. 额外注意事项

• 钩子回调要保持极简：你的回调已经做得很好了——只发送信号，不做任何耗时操作，这一点一定要坚持，避免在回调里添加IO、UI更新等操作。
• 卸载钩子：在程序退出时（比如Widget的析构函数），记得调用UnhookWindowsHookEx(hHook)，避免资源泄漏。
• 线程安全的数据库操作：QSqlDatabase对象是线程绑定的，所以必须在后台线程内部创建Database实例，不能直接复用主线程的Database对象，否则会触发线程安全问题。

这样修改后，主线程在启动后立刻进入消息循环处理钩子事件，数据库读取在后台悄悄完成，就不会再出现钩子失效的问题了。

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