C / C++ / 系统课时
用 Sanitizer 与 Valgrind 查内存问题
用 Sanitizer 与 Valgrind 查内存问题
内存越界、释放后使用、泄漏和未定义行为常常只在特定输入或负载下暴露。本课用一个可复现的 C 程序建立排查闭环:先用 ASan、UBSan 快速定位源码,再用 Valgrind Memcheck 对非 Sanitizer 调试构建做补充检查。
学习目标
- 能根据故障类型选择 AddressSanitizer、UndefinedBehaviorSanitizer 或 Valgrind Memcheck
- 能构建带调试信息的检查版本,并从第一条诊断定位源码位置
- 能在修复后重复运行检查,确认越界、未定义行为和泄漏已经消失
先选对检查器
AddressSanitizer(ASan)通过编译期插桩检查常见的越界访问、释放后使用等内存错误;UndefinedBehaviorSanitizer(UBSan)检查有符号整数溢出、非法移位、错误对齐等未定义行为。两者适合开发和测试阶段快速反馈。
Valgrind 的 Memcheck 不要求程序使用 Sanitizer 插桩,适合检查调试构建中的非法读写、未初始化值传播和内存泄漏。它通常明显慢于原生运行,因此更适合作为定向排查或测试环节,而不是生产进程的常驻检查器。
| 工具 | 更适合先查什么 | 构建方式 | 典型取舍 |
|---|---|---|---|
| ASan | 堆/栈越界、use-after-free | -fsanitize=address |
定位快,会增加内存和运行开销 |
| UBSan | C 语言未定义行为 | -fsanitize=undefined |
可与 ASan 组合,覆盖的不是普通内存泄漏 |
| Memcheck | 非法读写、未初始化值、泄漏 | 普通调试构建 | 无需 Sanitizer 插桩,但运行更慢 |
构造一个可复现故障
下面的程序把三类问题放在三个独立分支中:bounds 写到堆数组末尾之外,ub 触发有符号整数溢出,leak 故意遗漏 free。这样每次运行只暴露一种主故障,诊断不会互相遮挡。
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
static int run_bounds(void) {
int *p = malloc(4 * sizeof(*p));
if (p == NULL) {
return 1;
}
volatile int *view = p;
view[4] = 42; // 合法下标只有 0..3,这里故意越界
free(p);
return 0;
}
static int run_ub(void) {
volatile int x = INT_MAX;
int y = x + 1; // 有符号整数溢出属于未定义行为
printf("%d\n", y);
return 0;
}
static int run_leak(void) {
char *p = malloc(64);
if (p == NULL) {
return 1;
}
strcpy(p, "memory leak demo");
puts(p);
return 0; // 故意不释放 p
}
int main(int argc, char **argv) {
if (argc != 2) {
fprintf(stderr, "usage: %s bounds|ub|leak\n", argv[0]);
return 2;
}
if (strcmp(argv[1], "bounds") == 0) {
return run_bounds();
}
if (strcmp(argv[1], "ub") == 0) {
return run_ub();
}
if (strcmp(argv[1], "leak") == 0) {
return run_leak();
}
fprintf(stderr, "unknown case: %s\n", argv[1]);
return 2;
}这份源码本身只是故障载体。真正的定位信息来自下一步的构建参数和运行时诊断,因此不要先凭崩溃位置猜原因。
用 ASan 和 UBSan 抓第一现场
保留调试符号并尽量保留栈帧,能让报告更容易映射回源码。为避免两类检查器争抢同一个故障现场,这里从同一份源码生成两个构建:ASan 专门运行越界分支,UBSan 专门运行未定义行为分支。
gcc -O1 -g -fno-omit-frame-pointer \
-fsanitize=address \
mem_bug.c -o mem_bug_asan
./mem_bug_asan bounds || true
gcc -O1 -g -fno-omit-frame-pointer \
-fsanitize=undefined -fno-sanitize-recover=undefined \
mem_bug.c -o mem_bug_ubsan
./mem_bug_ubsan ub || true预期输出(截取关键诊断,地址和源码行号会因环境不同而变化):
==<PID>==ERROR: AddressSanitizer: heap-buffer-overflow on address <ADDR>
WRITE of size 4 at <ADDR>
#0 <ADDR> in <VALUE> <PATH>/mem_bug.c:<LINE>
...
<PATH>/mem_bug.c:<LINE>: runtime error: signed integer overflow: 2147483647 + 1 cannot be represented in type 'int'看到 ASan 报告时,优先处理第一条 ERROR 对应的非法访问,而不是追着后续连锁报错修。UBSan 同样要先修最早出现的未定义行为,因为编译器在遇到未定义行为后不再受普通 C 语义约束,后续现象可能失去参考价值。
用 Valgrind 补查泄漏
Valgrind 使用普通调试构建更清晰。这里关闭优化,保留 -g,再让 Memcheck 只展开确定泄漏的详细信息。
gcc -O0 -g mem_bug.c -o mem_bug_dbg
valgrind --leak-check=full --show-leak-kinds=definite ./mem_bug_dbg leak预期输出(进程号和调用地址会变化):
memory leak demo
==<PID>== 64 bytes in 1 blocks are definitely lost in loss record <VALUE>
==<PID>== at <ADDR>: malloc (<VALUE>)
==<PID>== by <ADDR>: run_leak (mem_bug.c:<LINE>)
==<PID>== ERROR SUMMARY: 1 errors from 1 contextsdefinitely lost 表示已经没有指针能再释放这块堆内存,应直接修复。若报告的是“未初始化值参与条件判断”,可以再加 --track-origins=yes 追溯值的来源,但它会进一步降低运行速度,不必默认对所有测试开启。
把报告变成修复闭环
本例的修复分别是:把 p[4] 改为合法下标或重新设计容量边界;在相加前做范围检查,或转换到能够容纳结果的更宽类型;在 run_leak 返回前执行 free(p)。修复后必须用同一输入再次运行 Sanitizer 和 Memcheck,而不是以“程序不崩了”作为通过标准。
一个可靠的日常顺序是:先在可复现测试中运行 ASan 与 UBSan,修完第一条真实错误后重跑;再对关键路径使用普通调试构建跑 Memcheck。最终应达到 Sanitizer 无诊断、Memcheck 的错误摘要为 0,并且没有 definitely lost 的泄漏记录。