C / C++ / 系统课时

用 Sanitizer 扫描内存错误

用 Sanitizer 扫描内存错误

Sanitizer 能把“偶发崩溃”变成带源码位置的可定位报告。本节用独立 Debug 构建同时开启 AddressSanitizer 与 UndefinedBehaviorSanitizer,再跑完整测试,最后把同样的检测环境带到命令行工具的典型使用路径中。

学习目标

  • 为 GCC 或 Clang 的 CMake 构建开启地址与未定义行为检测
  • 用 CTest 覆盖测试集,并识别越界、泄漏、释放后访问等报告
  • 建立“修复后重新跑全量测试和典型命令”的验收方式

用独立构建目录开启检测

不要在现有 Release 构建目录里临时追加 Sanitizer。单独使用 build-sanitize 可以避免缓存中的编译选项互相污染,也便于随时删除重建。下面的命令适用于 GCC 或 Clang。

bash
cmake -S . -B build-sanitize   -DCMAKE_BUILD_TYPE=Debug   -DCMAKE_C_FLAGS="-fsanitize=address,undefined -fno-omit-frame-pointer -g"   -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address,undefined"   -DCMAKE_SHARED_LINKER_FLAGS="-fsanitize=address,undefined" &&
cmake --build build-sanitize &&
printf 'build-exit=0\n'

预期输出的最后一行如下;前面的构建进度会随 CMake 生成器和项目目标而不同。

text
build-exit=0

-fsanitize=address 负责发现越界、释放后访问、重复释放等地址错误;-fsanitize=undefined 负责发现部分未定义行为。-fno-omit-frame-pointer 会让调用栈更容易还原。Sanitizer 会增加运行时开销,因此它适合测试与诊断构建,不应直接替代生产优化构建。

跑完整测试并保留失败现场

先让测试进程继承 Sanitizer 环境变量,再执行 CTest。halt_on_error=1 能让第一次错误尽快终止,减少后续连锁报错干扰根因;print_stacktrace=1 让 UBSan 尽量打印调用栈。

bash
ASAN_OPTIONS=detect_leaks=1:halt_on_error=1 UBSAN_OPTIONS=halt_on_error=1:print_stacktrace=1 ctest --test-dir build-sanitize --output-on-failure
status=$?
printf 'ctest-exit=%d\n' "$status"
exit "$status"

预期结果是在没有 Sanitizer 错误且所有测试通过时,以状态码 0 结束。

text
ctest-exit=0

如果环境支持 LeakSanitizer,detect_leaks=1 还会在进程退出时检查未释放内存;不同平台对泄漏检测的支持并不完全一致。只要输出里出现 AddressSanitizer、LeakSanitizer 或 runtime error,就应把这次执行视为失败,即使业务输出看起来正常。

从报告定位到具体错误

Sanitizer 报告最有价值的是“错误类型、首次出错位置、对象分配或释放位置”这三类信息。下面只是报告结构示意,路径和行号会随项目变化。

text
ERROR: AddressSanitizer: heap-buffer-overflow
WRITE of size 1 at <PATH>:<ID>
...
allocated by thread T0 here:
    <PATH>:<ID>
SUMMARY: AddressSanitizer: heap-buffer-overflow

看到 heap-buffer-overflow 时,先检查索引边界与缓冲区长度;看到 heap-use-after-free 时,沿释放位置确认对象生命周期;看到 double-free 时,检查所有权是否被多个路径重复释放。不要先压制报告或继续运行,而要优先修正第一处确定的非法内存操作。

再覆盖真实命令行路径

测试集通过后,还要用 Sanitizer 构建执行项目中已经存在的典型命令,尤其覆盖参数解析、文件读写、空输入、错误输入和退出路径。运行时继续带上同样的 ASAN_OPTIONS 与 UBSAN_OPTIONS,这样测试没有覆盖到的 CLI 分支也会被检测。

最终验收标准不是“命令没有崩溃”,而是完整测试与代表性命令都正常结束,标准错误中没有 Sanitizer 诊断,并且修复后仍能用普通 Debug 或 Release 构建通过原有测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Sanitizer 扫描内存错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通