Qt开发：软件崩溃时，如何生成dump文件

一、程序崩溃时如何自动生成 Dump 文件

步骤一：包含必要的头文件

#include <Windows.h>
#include <DbgHelp.h>

pro文件中添加库

LIBS += -lDbghelp

步骤二：创建生成 Dump 的函数

void CreateMiniDump(EXCEPTION_POINTERS* pep)
{SYSTEMTIME stLocalTime;GetLocalTime(&stLocalTime);TCHAR szFileName[MAX_PATH];swprintf_s(szFileName, MAX_PATH, L"CrashDump_%04d%02d%02d_%02d%02d%02d.dmp",stLocalTime.wYear, stLocalTime.wMonth, stLocalTime.wDay,stLocalTime.wHour, stLocalTime.wMinute, stLocalTime.wSecond);HANDLE hFile = CreateFile(szFileName, GENERIC_WRITE, 0, NULL, CREATE_ALWAYS,FILE_ATTRIBUTE_NORMAL, NULL);if ((hFile != NULL) && (hFile != INVALID_HANDLE_VALUE)){MINIDUMP_EXCEPTION_INFORMATION mdei;mdei.ThreadId = GetCurrentThreadId();mdei.ExceptionPointers = pep;mdei.ClientPointers = TRUE;BOOL success = MiniDumpWriteDump(GetCurrentProcess(),GetCurrentProcessId(),hFile,MiniDumpWithFullMemory,  // 你也可以用 MiniDumpNormal&mdei,nullptr,nullptr);CloseHandle(hFile);if (success) {QString msg = QString("程序崩溃啦！\nDump 文件已保存为：\n%1").arg(QString::fromWCharArray(szFileName));MessageBoxW(NULL, (LPCWSTR)msg.utf16(), L"崩溃提示", MB_OK | MB_ICONERROR);} else {MessageBoxW(NULL, L"程序崩溃啦！但保存 Dump 文件失败。", L"崩溃提示", MB_OK | MB_ICONERROR);}}
}

步骤三：设置异常处理函数

LONG WINAPI MyUnhandledExceptionFilter(EXCEPTION_POINTERS* pExceptionInfo) {CreateMiniDump(pExceptionInfo);return EXCEPTION_EXECUTE_HANDLER;
}

步骤四：在程序入口设置异常处理

int main(int argc, char *argv[])
{QApplication a(argc, argv);SetUnhandledExceptionFilter(MyUnhandledExceptionFilter);// 故意触发异常（测试用）int* p = nullptr;*p = 42;return a.exec();
}

二、支持多线程中的异常捕获

  C++ 中 SetUnhandledExceptionFilter 只能捕获未被 catch 的 SEH 异常。如果你用 Qt 的多线程（如 QThread），线程内部抛出的是 std::exception 或 Qt 异常，是不会自动走到 UnhandledExceptionFilter 的。

方法：在线程函数中加 __try/__except 包裹

unsigned __stdcall ThreadFunc(void* param)
{__try {// 正常线程代码int* p = nullptr;*p = 100; // 故意异常}__except (CreateMiniDump(GetExceptionInformation()), EXCEPTION_EXECUTE_HANDLER) {// 可选处理}return 0;
}

如果使用的是 QThread，可以重写 run() 方法，并包裹异常处理：

void MyThread::run()
{__try {// 正常逻辑}__except (CreateMiniDump(GetExceptionInformation()), EXCEPTION_EXECUTE_HANDLER) {// 崩溃时生成 dump}
}

三、在 DLL 中使用 Dump 捕获

如果写的是一个 DLL 插件，也可以捕获崩溃，在 DllMain 中设置异常处理：

BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpReserved)
{if (fdwReason == DLL_PROCESS_ATTACH) {SetUnhandledExceptionFilter(MyUnhandledExceptionFilter);}return TRUE;
}

四、封装成可复用类

可以把这整个流程封装成一个类，如：

class DumpCatcher
{
public:static void Init() {SetUnhandledExceptionFilter(UnhandledFilter);}private:static LONG WINAPI UnhandledFilter(EXCEPTION_POINTERS* pExceptionInfo) {CreateMiniDump(pExceptionInfo);return EXCEPTION_EXECUTE_HANDLER;}static void CreateMiniDump(EXCEPTION_POINTERS* pep);
};

然后在程序入口调用：

DumpCatcher::Init();

五、MiniDumpWriteDump函数详解

  MiniDumpWriteDump 是 Windows 平台下由 DbgHelp 库提供的函数，用于在应用程序崩溃或其他时机生成进程的内存转储（.dmp）文件，便于事后用调试器（如 Visual Studio、WinDbg）分析崩溃原因和程序状态。

函数原型：

BOOL MiniDumpWriteDump(HANDLE                            hProcess,DWORD                             ProcessId,HANDLE                            hFile,MINIDUMP_TYPE                     DumpType,PMINIDUMP_EXCEPTION_INFORMATION   ExceptionParam,PMINIDUMP_USER_STREAM_INFORMATION UserStreamParam,PMINIDUMP_CALLBACK_INFORMATION    CallbackParam
);

参数说明：

常用 MINIDUMP_TYPE：