Linux开发的跨平台应用Windows版本如何导出栈跟踪？

1. MinGW交叉编译下链接dbghelp的正确方式 #

MinGW-w64工具链已经内置了Windows系统库的导入库，其中就包含dbghelp.dll对应的libdbghelp.a，你不需要直接链接Windows原生DLL。交叉编译时只需在编译命令中追加-ldbghelp参数即可，示例编译命令：

i686-w64-mingw32-g++ -g -O2 your_game.cpp -o your_game.exe -ldbghelp

该库默认存放在MinGW的lib目录下，交叉编译环境会自动检索到它。

2. Windows下捕获崩溃并生成栈跟踪的实现 #

Windows下的段错误属于结构化异常（SEH），你需要注册全局异常处理函数来捕获，再调用dbghelp的API生成栈跟踪。核心代码示例：

#ifdef _WIN32
#include <windows.h>
#include <dbghelp.h>
#include <iostream>
#include <cstdio>
#include <cstdlib>
#include <cstring>

// 异常处理回调函数
LONG WINAPI CrashHandler(EXCEPTION_POINTERS* ExceptionInfo) {
    HANDLE hProcess = GetCurrentProcess();
    // 初始化符号库，开启行号加载
    SymInitialize(hProcess, NULL, TRUE);
    SymSetOptions(SYMOPT_LOAD_LINES | SYMOPT_DEFERRED_LOADS);

    CONTEXT* context = ExceptionInfo->ContextRecord;
    STACKFRAME64 stackFrame;
    memset(&stackFrame, 0, sizeof(stackFrame));

    // 针对32位x86架构设置初始栈帧
#ifdef _M_IX86
    stackFrame.AddrPC.Offset = context->Eip;
    stackFrame.AddrPC.Mode = AddrModeFlat;
    stackFrame.AddrStack.Offset = context->Esp;
    stackFrame.AddrStack.Mode = AddrModeFlat;
    stackFrame.AddrFrame.Offset = context->Ebp;
    stackFrame.AddrFrame.Mode = AddrModeFlat;
#endif

    std::cout << "崩溃触发，栈跟踪信息：\n";
    int frameCount = 0;
    while (StackWalk64(
        IMAGE_FILE_MACHINE_I386,
        hProcess,
        GetCurrentThread(),
        &stackFrame,
        context,
        NULL,
        SymFunctionTableAccess64,
        SymGetModuleBase64,
        NULL
    )) {
        if (stackFrame.AddrPC.Offset == 0) break;

        char symbolName[256] = {0};
        DWORD64 displacement = 0;
        SYMBOL_INFO* symbolInfo = (SYMBOL_INFO*)malloc(sizeof(SYMBOL_INFO) + 256);
        symbolInfo->SizeOfStruct = sizeof(SYMBOL_INFO);
        symbolInfo->MaxNameLen = 255;

        if (SymFromAddr(hProcess, stackFrame.AddrPC.Offset, &displacement, symbolInfo)) {
            snprintf(symbolName, sizeof(symbolName), "%s", symbolInfo->Name);
        } else {
            snprintf(symbolName, sizeof(symbolName), "0x%llx", stackFrame.AddrPC.Offset);
        }

        // 获取行号信息
        IMAGEHLP_LINE64 lineInfo;
        memset(&lineInfo, 0, sizeof(lineInfo));
        lineInfo.SizeOfStruct = sizeof(lineInfo);
        DWORD lineDisplacement = 0;
        if (SymGetLineFromAddr64(hProcess, stackFrame.AddrPC.Offset, &lineDisplacement, &lineInfo)) {
            std::cout << "#" << frameCount << " " << symbolName << " 位于 " << lineInfo.FileName << ":" << lineInfo.LineNumber << "\n";
        } else {
            std::cout << "#" << frameCount << " " << symbolName << " (地址：0x" << std::hex << stackFrame.AddrPC.Offset << ")\n";
        }

        free(symbolInfo);
        frameCount++;
    }

    SymCleanup(hProcess);
    // 可将栈跟踪写入文件，方便后续分析
    // FILE* f = fopen("crash_trace.txt", "w");
    // // 重复上述输出逻辑写入文件
    // fclose(f);

    return EXCEPTION_EXECUTE_HANDLER;
}

// 程序初始化时注册异常处理
void SetupCrashHandler() {
    SetUnhandledExceptionFilter(CrashHandler);
}
#endif

在游戏初始化阶段调用SetupCrashHandler()，即可捕获未处理的异常（包括段错误）并生成栈跟踪。

3. 解决boost::stacktrace乱码问题 #

乱码源于Windows默认使用GBK编码，而Linux环境为UTF-8。你可以在输出时将宽字符转换为UTF-8：

#ifdef _WIN32
#include <windows.h>
#include <boost/stacktrace.hpp>
#include <codecvt>
#include <fstream>

void PrintStacktrace() {
    auto trace = boost::stacktrace::stacktrace();
    std::wstring_convert<std::codecvt_utf8<wchar_t>> converter;
    std::string utf8Trace = converter.to_bytes(trace.to_string());
    std::cout << utf8Trace << "\n";
    
    // 写入文件避免终端编码问题
    std::ofstream out("crash_trace.txt");
    out << utf8Trace;
}
#endif

编译时需链接boost的stacktrace库，交叉编译要确保有针对MinGW的boost库，编译参数追加-lboost_stacktrace_windbg（Windows下依赖dbghelp的后端）。

4. 编译关键注意事项 #

• 必须添加-g参数生成调试信息，否则无法解析函数名和行号；
• 发布版本可保留-g -O2，MinGW支持带优化的调试信息；
• 若符号解析不全，确保程序及依赖库的调试信息完整，或在SymInitialize后调用SymLoadModuleEx手动加载模块符号。

你的思路没问题，只是需要正确利用MinGW提供的系统库包装，以及适配Windows平台的异常机制和编码差异。

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