Qt5+Windows10环境下Sentry捕获崩溃/无响应事件及获取崩溃位置函数名的解决方案咨询

我之前在Qt5+Windows10环境下用Sentry做崩溃监控时也遇到过同样的问题，给你分享下我实测有效的解决方案：

Qt本身没有直接的无响应事件通知，但我们可以通过两种方式来检测并上报给Sentry：

• 主线程心跳检测法
  原理是利用Qt的线程调度特性：如果主线程卡住，发送给它的异步调用会无法及时执行。你可以创建一个独立的监控线程，每隔几秒向主线程发送一个心跳请求，超过阈值没收到回应就判定为无响应，主动上报Sentry。
  示例代码如下：

  #include <QThread>
  #include <QTimer>
  #include <QApplication>
  #include <sentry.h>
  
  class WatchdogThread : public QThread {
      Q_OBJECT
  protected:
      void run() override {
          QTimer timer;
          connect(&timer, &QTimer::timeout, this, [this]() {
              bool isMainThreadResponsive = false;
              // 异步调用主线程的匿名函数，检测是否能执行
              QMetaObject::invokeMethod(qApp, [&isMainThreadResponsive]() {
                  isMainThreadResponsive = true;
              }, Qt::QueuedConnection);
              // 等待100ms看主线程是否响应
              QThread::msleep(100);
              if (!isMainThreadResponsive) {
                  // 上报无响应事件到Sentry
                  sentry_capture_message("Application main thread unresponsive", SENTRY_LEVEL_WARNING);
              }
          });
          timer.start(5000); // 每5秒检测一次
          exec();
      }
  };
  
  // 在main函数中启动监控线程
  int main(int argc, char *argv[]) {
      QApplication a(argc, argv);
      // 初始化Sentry...
      WatchdogThread watchdog;
      watchdog.start();
      // 启动应用...
      return a.exec();
  }
  

• Windows系统API检测法
  Windows提供了IsHungAppWindow API，可以直接检测窗口是否无响应。你可以在主线程中启动一个定时器，定时检测主窗口状态：

  #include <windows.h>
  #include <QTimer>
  #include <sentry.h>
  
  int main(int argc, char *argv[]) {
      QApplication a(argc, argv);
      // 初始化Sentry...
      QTimer checkTimer;
      connect(&checkTimer, &QTimer::timeout, []() {
          HWND mainWindowHandle = (HWND)qApp->activeWindow()->winId();
          if (IsHungAppWindow(mainWindowHandle)) {
              sentry_capture_message("Application window is unresponsive", SENTRY_LEVEL_ERROR);
          }
      });
      checkTimer.start(3000); // 每3秒检测一次
      // 启动应用...
      return a.exec();
  }
  

  这个方法更贴合Windows系统对无响应窗口的判定逻辑，适合需要和系统行为对齐的场景。

Sentry显示内存地址而不是函数名，核心原因是缺少对应的调试符号文件。按照以下步骤操作就能解决：

• 第一步：编译时生成调试符号
  不管是Debug还是Release模式，都要确保编译器生成调试符号：

  • 如果你用MSVC编译器：在Qt Creator的项目构建设置中，勾选"Generate debug information"（对应编译器参数/Zi）。Release模式下用/Zi配合/O2优化，生成的PDB文件不会让程序体积暴涨。
  • 如果你用MinGW编译器：在编译参数中添加-g（Debug）或-g1（Release轻量符号），生成DWARF格式的调试符号。

• 第二步：上传调试符号到Sentry
  Sentry需要匹配崩溃程序的符号文件才能解析地址，推荐用Sentry CLI工具上传：

  # 上传MSVC的PDB文件
  sentry-cli upload-dif --org 你的组织名 --project 你的项目名 ./release/YourApp.pdb
  # 上传MinGW的符号（直接传exe即可，符号嵌在exe里）
  sentry-cli upload-dif --org 你的组织名 --project 你的项目名 ./release/YourApp.exe
  

  注意要提前设置SENTRY_AUTH_TOKEN环境变量（从Sentry控制台获取），也可以在Qt的.pro文件中添加构建后步骤，自动完成符号上传。

• 第三步：验证符号上传状态
  登录Sentry控制台，进入你的项目，在Settings -> Debug Files中可以查看已上传的符号。当新的崩溃事件发生时，Sentry会自动匹配符号，把内存地址解析成具体的函数名、文件名和行号。

额外提醒：Release模式下如果开启了过度优化，可能会导致部分符号被剥离，这时候尽量用轻量符号生成参数，同时确保上传的符号和崩溃程序的版本完全一致（包括编译哈希），否则Sentry无法匹配。

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