可通过重写__asan_report_error函数自定义ASan错误上报,需静态链接ASan、严格匹配5参数签名,结合__sanitizer_print_stack_trace获取堆栈;对未插桩代码可用mmap(PROT_NONE)保护内存页并捕获SIGSEGV,二者均需避免在处理中调用非异步信号安全函数。

用 __asan_report_error 触发 ASan 的自定义上报逻辑
Clang/GCC 编译的 C++ 程序启用 AddressSanitizer(ASan)后,一旦发生越界读写,会默认 abort 并打印堆栈。但你不能直接拦截 abort() 或信号——ASan 的错误报告走的是内部函数 __asan_report_error,它在崩溃前最后一步调用,且允许你替换实现。
关键点:必须用 -fsanitize=address 编译,且链接时不能带 -shared-libasan(否则无法覆盖符号),推荐静态链接 ASan 运行时(-static-libasan)。
- 在全局作用域定义
void __asan_report_error(...),签名要严格匹配(参数共 5 个:uintptr_t addr, uintptr_t pc, uintptr_t bp, uintptr_t sp, int32_t type) -
type值为 0 表示越界读,1 表示越界写,2 是 use-after-free,可据此分类上报 - 调用
__sanitizer_print_stack_trace()获取当前堆栈(需包含<sanitizer></sanitizer>) - 不要在该函数里做复杂操作(如 malloc、锁、IO),避免二次崩溃;建议只写入预分配的 ring buffer 或 mmap 区域
用 mmap + PROT_NONE 拦截非法地址访问
ASan 是编译期插桩,对未插桩代码(如第三方库、内联汇编、memcpy 调用)无效。此时可用 mmap 保护内存页边界:在目标缓冲区前后各映射一页 PROT_NONE 内存,任何越界访问立即触发 SIGSEGV。
典型场景:监控某块堆分配内存(如 char* buf = new char[1024]),想捕获 buf[-1] 或 buf[1024] 访问。
立即学习“C++免费学习笔记(深入)”;
- 用
posix_memalign(&ptr, 4096, size + 8192)分配足够空间(前后各留一页) -
mmap(ptr, 4096, PROT_NONE, MAP_FIXED|MAP_PRIVATE|MAP_ANONYMOUS, -1, 0)封锁低页 -
mmap(ptr + 4096 + size, 4096, PROT_NONE, MAP_FIXED|MAP_PRIVATE|MAP_ANONYMOUS, -1, 0)封锁高页 - 注册
sigaction(SIGSEGV, &sa, nullptr),在 handler 中检查si_addr是否落在保护页内 - 注意:handler 里不能调用
printf、malloc等非 async-signal-safe 函数;可用write(2)直接写 fd
为什么不用 setjmp/longjmp 或 try/catch 捕获越界?
C++ 异常和 setjmp 都不捕获非法内存访问——它们是语言级控制流机制,而越界是硬件异常(x86 上是 #GP 或 #PF),由 OS 以信号(SIGSEGV)投递,与 C++ 异常无关。
常见误解:以为 try { dangerous(); } catch(...) {} 能兜住越界。实际结果是程序直接终止,catch 块永不执行。
-
try/catch只捕获throw抛出的异常,不是信号 -
setjmp/longjmp在 signal handler 中使用需配合sigsetjmp,且仅适用于同步信号(如SIGBUS在某些平台可,SIGSEGV不保证可恢复) - 即便能跳转回来,CPU 状态和寄存器可能已损坏,继续执行风险极高
上报内容必须包含 __builtin_return_address(0) 和 addr
单纯记录堆栈不够定位问题:ASan 的堆栈可能停留在 runtime 插桩点(如 __asan_load4),而非用户代码行;mmap 方案的 si_addr 才是真实越界地址。
所以日志至少含三项:fault_addr(出错地址)、access_pc(触发访问的指令地址)、stack_trace(从 __builtin_return_address(0) 开始回溯)。
- 用
backtrace()+backtrace_symbols()获取符号化堆栈,但要注意它们会 malloc —— 可改用libunwind的unw_backtrace实现无 malloc 回溯 -
access_pc比堆栈顶层更可靠:它指向你代码中那条出问题的buf[i] = x指令,而不是 ASan 的检查函数 - 生产环境建议关闭符号解析,只存 raw 地址 + 映射文件 offset,事后用
addr2line -e binary -fCi解析
越界监控真正的难点不在捕获,而在不干扰原有逻辑、不引入新 crash、且上报信息足够还原现场——尤其是多线程下信号处理和 ASan hook 的竞态,稍不注意就会掩盖原始问题。


















