C / C++ / 系统课时
用 Sanitizer 扫描内存错误
用 Sanitizer 扫描内存错误
Sanitizer 能把“偶发崩溃”变成带源码位置的可定位报告。本节用独立 Debug 构建同时开启 AddressSanitizer 与 UndefinedBehaviorSanitizer,再跑完整测试,最后把同样的检测环境带到命令行工具的典型使用路径中。
学习目标
- 为 GCC 或 Clang 的 CMake 构建开启地址与未定义行为检测
- 用 CTest 覆盖测试集,并识别越界、泄漏、释放后访问等报告
- 建立“修复后重新跑全量测试和典型命令”的验收方式
用独立构建目录开启检测
不要在现有 Release 构建目录里临时追加 Sanitizer。单独使用 build-sanitize 可以避免缓存中的编译选项互相污染,也便于随时删除重建。下面的命令适用于 GCC 或 Clang。
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 生成器和项目目标而不同。
build-exit=0-fsanitize=address 负责发现越界、释放后访问、重复释放等地址错误;-fsanitize=undefined 负责发现部分未定义行为。-fno-omit-frame-pointer 会让调用栈更容易还原。Sanitizer 会增加运行时开销,因此它适合测试与诊断构建,不应直接替代生产优化构建。
跑完整测试并保留失败现场
先让测试进程继承 Sanitizer 环境变量,再执行 CTest。halt_on_error=1 能让第一次错误尽快终止,减少后续连锁报错干扰根因;print_stacktrace=1 让 UBSan 尽量打印调用栈。
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 结束。
ctest-exit=0如果环境支持 LeakSanitizer,detect_leaks=1 还会在进程退出时检查未释放内存;不同平台对泄漏检测的支持并不完全一致。只要输出里出现 AddressSanitizer、LeakSanitizer 或 runtime error,就应把这次执行视为失败,即使业务输出看起来正常。
从报告定位到具体错误
Sanitizer 报告最有价值的是“错误类型、首次出错位置、对象分配或释放位置”这三类信息。下面只是报告结构示意,路径和行号会随项目变化。
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 构建通过原有测试。