MSVC下注册SIGSEGV信号处理器为何无法捕获段错误？

DevOps 小满

2026-6-29

问题描述

我注意到C++23提供了std::stacktrace，我们的单元测试在Jenkins上偶发段错误但本地无法复现，因此希望借助它排查问题。我们先基于支持std::stacktrace的MSVC 17进行测试，后续也会部署到Linux环境。需要说明两点：

我知道捕获段错误并不简单，信号处理器中不能调用malloc()等函数，虽可通过静态内存池规避malloc问题，但printf()、std::cerr等较难避免，不过这仅用于测试代码，不会影响生产代码；
我们使用/Ehsc编译选项，无法使用Windows特定的SEH异常处理。

但我注册的信号处理器并未被调用，以下是我的代码实现：

#include <gtest/gtest.h>

#include <csignal>
#include <cstdlib>
#include <stacktrace>


static void SignalHandler(int signal);
static void SignalHandler(int signal)
{
  const std::stacktrace stacktrace = std::stacktrace::current(0, 10);
  std::cerr << "Caught Signal " << signal <<": " << stacktrace << std::endl;
}

int main(int argc, char* argv[])
{
#if defined(_MSC_VER) && defined(_DEBUG)
  _set_error_mode(_OUT_TO_STDERR);
  _CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);
#endif

  [[maybe_unused]] auto prevSignalHandlerSegfault = std::signal(SIGSEGV, SignalHandler);
  ::testing::InitGoogleTest(&argc, argv);
  int res = RUN_ALL_TESTS();
  return res;
}

测试用例中我通过以下代码触发段错误：

TEST(Foo,Bar)
{
  int* pFoo = nullptr;
  *pFoo = 10;
}

我在SignalHandler()中设置了断点，但从未进入该函数，控制台仅显示：

unknown file: error: SEH exception with code 0xc0000005 thrown in the test body.

请问我遗漏了什么？难道无法通过覆盖信号处理器来捕获段错误吗？

解决方案

核心问题是：Google Test在Windows平台下会自动用SEH（结构化异常处理）捕获测试执行过程中的异常，包括空指针解引用这类触发SIGSEGV的错误，所以你的信号处理器根本没机会被调用——Google Test先一步拦截了异常，输出了你看到的错误信息。

针对这个问题，有几个可行的解决方向：

1. 禁用Google Test的SEH异常捕获

Google Test提供了全局控制选项，可以关闭它对测试异常的自动捕获。这样测试触发段错误时，你的信号处理器就能正常生效。

你可以通过两种方式设置：

运行测试程序时添加命令行参数：--gtest_catch_exceptions=0
在代码中提前设置标志位，修改main函数如下：

int main(int argc, char* argv[])
{
#if defined(_MSC_VER) && defined(_DEBUG)
  _set_error_mode(_OUT_TO_STDERR);
  _CrtSetDbgFlag(_CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF);
#endif

  // 关闭Google Test的异常捕获，让信号处理器生效
  ::testing::GTEST_FLAG(catch_exceptions) = false;

  [[maybe_unused]] auto prevSignalHandlerSegfault = std::signal(SIGSEGV, SignalHandler);
  ::testing::InitGoogleTest(&argc, argv);
  int res = RUN_ALL_TESTS();
  return res;
}

注意：这个设置是全局的，一旦测试中出现未处理异常，程序会直接触发你的信号处理器，而非被Google Test拦截后继续执行后续测试。

2. 针对单个测试用例手动捕获异常（兼容/Ehsc）

虽然你使用/Ehsc编译选项（该选项仅同步C++异常，不自动捕获SEH异常），但直接使用SEH的__try/__except语法是允许的，不会和编译选项冲突。你可以封装一个辅助函数，在需要的测试用例中包裹执行逻辑：

#include <excpt.h>
#include <functional>

// 辅助函数：捕获SEH异常并生成栈追踪
static void ExecuteWithStacktraceCapture(std::function<void()> func)
{
    __try
    {
        func();
    }
    __except(GetExceptionCode() == EXCEPTION_ACCESS_VIOLATION ? EXCEPTION_EXECUTE_HANDLER : EXCEPTION_CONTINUE_SEARCH)
    {
        const std::stacktrace stacktrace = std::stacktrace::current(0, 10);
        std::cerr << "Caught SEH exception (code: 0x" << std::hex << GetExceptionCode() << "): " << stacktrace << std::endl;
        // 重新抛出异常，让Google Test标记测试失败
        throw;
    }
}

TEST(Foo,Bar)
{
    ExecuteWithStacktraceCapture([](){
        int* pFoo = nullptr;
        *pFoo = 10;
    });
}

这种方式更灵活，仅对包裹的代码生效，不会影响其他测试用例的执行流程。

3. Linux环境的注意事项

后续部署到Linux时，情况会更简单：Linux下的信号机制不会被Google Test直接拦截（除非开启特定异常捕获选项），你注册的SIGSEGV处理器应该能正常触发。但要注意：

std::stacktrace在Linux下需要链接libstdc++的调试库，编译时可能需要添加-lstdc++_libbacktrace链接选项；
信号处理器中调用std::cerr等IO操作确实存在风险，但你已明确这仅用于测试环境，无需过度担心。

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

MSVC下注册SIGSEGV信号处理器为何无法捕获段错误？

1. 禁用Google Test的SEH异常捕获 #

2. 针对单个测试用例手动捕获异常（兼容/Ehsc） #

3. Linux环境的注意事项 #

1. 禁用Google Test的SEH异常捕获

2. 针对单个测试用例手动捕获异常（兼容/Ehsc）

3. Linux环境的注意事项