如何捕获C++中所有异常并输出详细信息？

Question

在C++开发中，如何全局捕获所有未处理的异常并输出其详细信息（如异常类型、消息、调用栈）是一个常见难题。特别是在多线程环境下，std::set_terminate或signal handler难以获取完整的上下文信息。开发者常困惑于：如何统一拦截std::exception及其派生类、未知异常（如空指针解引用），并打印可读性强的错误堆栈？常用方法如结合try-catch块、std::set_unexpected（已弃用）、结构化异常处理（Windows SEH）或第三方库（如Boost.Exception、backward.cpp）是否可靠？如何在不依赖调试符号的情况下实现跨平台的异常捕获与回溯？

Answer 1

在C++中实现全局异常捕获与调用栈回溯：从基础到跨平台高级方案

1. 异常类型与未处理异常的基本分类

C++中的异常主要分为两类：

• 标准异常（std::exception 及其派生类）：如 std::runtime_error、std::logic_error 等，可通过 try-catch 捕获。
• 非标准异常或硬件异常：如空指针解引用、除零、栈溢出等，属于信号（signal）或结构化异常（SEH），无法通过常规 catch 捕获。

当异常未被捕获时，程序会调用 std::terminate()，默认行为是终止进程，不输出任何调试信息。

2. 初级方案：使用 std::set_terminate 捕获终止流程

通过设置自定义的 terminate handler，可以在程序崩溃前执行清理和日志记录：

#include <exception>
#include <iostream>

void my_terminate_handler() {
    std::cerr << "Uncaught exception or abnormal termination detected!" << std::endl;
    // 此处无法获取异常对象本身
    std::abort();
}

int main() {
    std::set_terminate(my_terminate_handler);
    throw std::runtime_error("Test exception");
}
    

局限性在于：无法获取异常类型和消息，且多线程环境下每个线程需独立注册。

3. 中级策略：结合顶层 try-catch 与线程局部存储

对于主线程，可在 main 函数外层包裹 try-catch：

int main() {
    try {
        // 主逻辑
        return real_main();
    } catch (const std::exception& e) {
        std::cerr << "Caught std::exception: " << e.what() << std::endl;
    } catch (...) {
        std::cerr << "Caught unknown exception" << std::endl;
    }
    return -1;
}
    

对于子线程，应使用线程函数包装：

线程函数	是否需要包装	建议做法
std::thread lambda	是	内部加 try-catch
pthread_create 回调	是	封装 C 函数调用 C++ 异常处理
异步任务（如 std::async）	否	异常会被 future 捕获

4. 高级机制：信号处理与结构化异常处理（SEH）

在 Unix/Linux 上，可使用 signal 处理器捕获 SIGSEGV、SIGFPE 等：

#include <signal.h>
void signal_handler(int sig) {
    std::cerr << "Signal received: " << sig << std::endl;
    // 可调用 backtrace 输出栈帧
    std::exit(1);
}
signal(SIGSEGV, signal_handler);
    

Windows 平台支持 SEH（Structured Exception Handling）：

__try {
    int* p = nullptr;
    *p = 42;
} __except(EXCEPTION_EXECUTE_HANDLER) {
    std::cerr << "SEH caught access violation" << std::endl;
}
    

但 SEH 不是跨平台的，且与 C++ 异常机制不兼容。

5. 跨平台解决方案：backward.cpp 库实践

backward.cpp 是一个轻量级、无依赖的堆栈回溯库，支持 Linux、macOS、Windows。

#include <backward.hpp>
namespace backward {
    backward::SignalHandling sh;
}

int main() {
    char* p = nullptr;
    *p = 'a'; // 触发 SIGSEGV
}
    

输出示例：

Backtrace:
  #0  0x7f8b2c1d6f47 in raise
  #1  0x7f8b2c1d88b8 in abort
  #2  0x4011b2 in main at example.cpp:10
    

它通过解析 unwind 信息生成调用栈，无需调试符号即可工作。

6. Boost.Exception 与异常增强机制

Boost.Exception 允许在异常中附加上下文信息：

#include <boost/exception/all.hpp>
typedef boost::error_info<struct tag_errmsg, std::string> errmsg_info;

try {
    BOOST_THROW_EXCEPTION(std::runtime_error("Error") << errmsg_info("Additional context"));
} catch (const boost::exception& e) {
    std::cerr << boost::diagnostic_information(e);
}
    

虽不能捕获硬件异常，但提升了错误可读性。

7. 实现统一异常拦截器的架构设计

理想方案应整合以下组件：

1. 主线程：main 外层 try-catch
2. 子线程：自动包装入口函数
3. terminate handler：处理未捕获的 C++ 异常
4. signal/SEH handler：处理访问违规等系统异常
5. 堆栈回溯引擎：如 libbacktrace、libunwind 或 backward.cpp
6. 符号解析：地址 → 函数名（支持 DWARF、PDB、ELF 等格式）

8. 调用栈回溯技术原理与实现方式对比

技术	平台支持	是否需调试符号	精度	性能开销
libunwind	Linux/macOS	部分	高	中
backtrace (glibc)	Linux	是	中	低
WinDbg API (dbghelp.dll)	Windows	是	高	中
backward.cpp	跨平台	否	高	中
compiler-rt (sanitizers)	跨平台	是	极高	高

9. 使用 Mermaid 展示异常捕获流程

graph TD
    A[程序运行] --> B{发生异常?}
    B -- C++ exception --> C[进入 catch 块]
    B -- Signal/SEH --> D[触发 signal handler]
    C --> E[打印异常类型与消息]
    D --> F[生成调用栈回溯]
    E --> G[记录日志并退出]
    F --> G
    G --> H[结束进程]
    

10. 最佳实践建议与未来方向

推荐组合方案：

• 使用 backward.cpp 实现跨平台堆栈回溯
• 为所有线程入口添加异常包装器
• 注册 std::set_terminate 和信号处理器
• 启用编译器的栈展开支持（如 -funwind-tables）
• 在发布版本中保留部分符号信息（strip --only-keep-debug）

未来可探索与 ASan、UBSan 等 sanitizer 工具集成，实现更全面的错误诊断能力。