Windows环境下C++程序崩溃时如何简单生成栈追踪转储文件

底层实现逻辑 #

Windows下用户态程序崩溃的本质是触发了未被处理的异常，内核会向异常进程发送异常通知，默认行为是启动系统自带的WerFault.exe结束进程。栈追踪的核心逻辑是两步：

1. 拿到异常发生时的上下文信息，包括指令指针、栈指针、帧指针等寄存器值
2. 从栈顶开始遍历栈帧，通过调试符号文件把内存地址映射成可读的函数名、文件名、行号信息，最终写入文件

细化问题解答 #

1. 是否需要通过另一个进程启动目标程序执行日志记录？ #

不是必须，但外部进程方案稳定性更高。

• 简单场景可以直接在崩溃进程内部处理，实现成本极低，绝大多数场景可用
• 极端崩溃场景（如栈溢出、进程地址空间完全损坏）下，崩溃进程自身的栈、堆已经不可用，内部执行写日志逻辑可能出现二次崩溃，这种对稳定性要求极高的场景推荐用外部监控进程捕获崩溃

2. 如何捕获程序的崩溃错误？ #

调用Windows系统原生API SetUnhandledExceptionFilter 给进程注册全局未处理异常回调即可，所有没有被try-catch捕获的异常都会进入该回调，回调参数会直接传入异常上下文指针，可直接用于栈解析。
如果采用外部进程方案，可通过CreateProcess以调试模式启动目标进程，通过WaitForDebugEvent捕获EXCEPTION_DEBUG_EVENT调试事件获取异常上下文。

3. 程序需要采用哪种编译模式？ #

推荐用RelWithDebInfo模式，Debug模式也可使用，纯Release模式（无调试信息）无法解析符号。
编译时需要开启两个配置项：

• 编译器选项：/Zi 生成独立的pdb调试符号文件
• 链接器选项：/DEBUG 生成完整符号映射，同时保留/OPT:REF /OPT:ICF配置即可保留和纯Release一致的优化等级，性能无明显损失

4. 是否需要同步发布调试符号文件？ #

是必须的。内存地址到函数名、行号的映射完全存储在pdb文件中，程序运行时会自动查找同目录下的对应pdb文件完成解析，不需要将pdb嵌入到可执行文件中，避免可执行文件体积过度膨胀。

具体实现代码示例（MSVC环境，64位程序） #

#include <windows.h>
#include <DbgHelp.h>
#include <fstream>
#include <iostream>
// 链接DbgHelp库
#pragma comment(lib, "Dbghelp.lib")

LONG WINAPI UnhandledExceptionCallback(PEXCEPTION_POINTERS pExceptionInfo) {
    // 打开崩溃日志文件
    std::ofstream logFile("crash_stacktrace.log", std::ios::out | std::ios::trunc);
    if (!logFile.is_open()) {
        return EXCEPTION_CONTINUE_SEARCH;
    }

    HANDLE hProcess = GetCurrentProcess();
    // 初始化符号引擎
    SymInitialize(hProcess, NULL, TRUE);
    SymSetOptions(SYMOPT_LOAD_LINES | SYMOPT_UNDNAME);

    STACKFRAME64 stackFrame = {0};
    CONTEXT* pContext = pExceptionInfo->ContextRecord;
    // 初始化栈帧寄存器值（32位程序将Rip/Rbp/Rsp替换为Eip/Ebp/Esp即可）
    stackFrame.AddrPC.Offset = pContext->Rip;
    stackFrame.AddrPC.Mode = AddrModeFlat;
    stackFrame.AddrFrame.Offset = pContext->Rbp;
    stackFrame.AddrFrame.Mode = AddrModeFlat;
    stackFrame.AddrStack.Offset = pContext->Rsp;
    stackFrame.AddrStack.Mode = AddrModeFlat;

    logFile << "程序崩溃栈追踪：" << std::endl;
    int frameIndex = 0;
    char symbolBuffer[sizeof(SYMBOL_INFO) + 1024] = {0};
    PSYMBOL_INFO pSymbol = (PSYMBOL_INFO)symbolBuffer;
    pSymbol->SizeOfStruct = sizeof(SYMBOL_INFO);
    pSymbol->MaxNameLen = 1024;

    // 遍历栈帧（32位程序将第一个参数改为IMAGE_FILE_MACHINE_I386即可）
    while (StackWalk64(IMAGE_FILE_MACHINE_AMD64, hProcess, GetCurrentThread(), 
        &stackFrame, pContext, NULL, SymFunctionTableAccess64, SymGetModuleBase64, NULL)) {
        if (stackFrame.AddrPC.Offset == 0) break;

        DWORD64 symDisplacement = 0;
        if (SymFromAddr(hProcess, stackFrame.AddrPC.Offset, &symDisplacement, pSymbol)) {
            IMAGEHLP_LINE64 lineInfo = {0};
            lineInfo.SizeOfStruct = sizeof(IMAGEHLP_LINE64);
            DWORD lineDisplacement = 0;
            if (SymGetLineFromAddr64(hProcess, stackFrame.AddrPC.Offset, &lineDisplacement, &lineInfo)) {
                logFile << "[" << frameIndex << "] " << pSymbol->Name << " (文件：" 
                    << lineInfo.FileName << " 行号：" << lineInfo.LineNumber 
                    << " 偏移：0x" << std::hex << symDisplacement << ")" << std::endl;
            } else {
                logFile << "[" << frameIndex << "] " << pSymbol->Name 
                    << " (偏移：0x" << std::hex << symDisplacement << ")" << std::endl;
            }
        } else {
            logFile << "[" << frameIndex << "] 未知函数，地址：0x" 
                << std::hex << stackFrame.AddrPC.Offset << std::endl;
        }
        frameIndex++;
    }

    SymCleanup(hProcess);
    logFile.close();
    // 执行完日志写入后结束进程
    return EXCEPTION_EXECUTE_HANDLER;
}

int main() {
    // 程序启动时首先注册异常回调
    SetUnhandledExceptionFilter(UnhandledExceptionCallback);

    // 测试崩溃代码，可注释掉
    int* p = nullptr;
    *p = 1;

    return 0;
}

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