C / C++ / 系统课时
用 AddressSanitizer 查内存错误
用 AddressSanitizer 查内存错误
越界、释放后访问和重复释放往往不会在出错语句处立即表现为崩溃。AddressSanitizer 会在编译阶段插入检查,并在运行时报告非法内存访问。本课用一个可复现实验掌握启用方式、错误类型和诊断信息的阅读顺序。
学习目标
- 使用 GCC 或 Clang 为 C 程序启用 AddressSanitizer
- 识别越界、释放后访问和重复释放的关键诊断名称
- 根据访问位置、分配位置和释放位置回到源码定位根因
编译时启用 AddressSanitizer
AddressSanitizer 通常简称 ASan。使用 GCC 或 Clang 时,核心选项是 -fsanitize=address。调试阶段还建议保留调试信息和栈帧,使报告中的调用栈更容易对应到源码。
下面创建一个实验程序,通过命令行参数选择三种典型错误。每次运行只触发一种错误,避免第一个异常终止后遮住其他问题。
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
static int *alloc_four(void) {
int *p = malloc(4 * sizeof *p);
if (p == NULL) {
perror("malloc");
exit(EXIT_FAILURE);
}
return p;
}
int main(int argc, char **argv) {
if (argc != 2) {
fprintf(stderr, "usage: %s overflow|uaf|doublefree\n", argv[0]);
return 2;
}
int *p = alloc_four();
p[0] = 7;
if (strcmp(argv[1], "overflow") == 0) {
p[4] = 99; // 合法下标只有 0~3。
printf("%d\n", p[4]);
free(p);
} else if (strcmp(argv[1], "uaf") == 0) {
free(p);
printf("%d\n", p[0]); // 已释放后再次读取。
} else if (strcmp(argv[1], "doublefree") == 0) {
free(p);
free(p); // 同一所有权被释放两次。
} else {
free(p);
fprintf(stderr, "unknown mode\n");
return 2;
}
return 0;
}预期结果:源文件支持 overflow、uaf 和 doublefree 三种模式。普通运行这些分支会触发未定义行为,因此不要把“这次没有崩溃”当成代码正确;下一步应使用 ASan 构建后再验证。
使用下面的命令编译。-g 保留调试信息,-fno-omit-frame-pointer 有助于获得更完整的调用栈,-O1 则保留基本优化同时方便调试。
cc -g -O1 -fsanitize=address -fno-omit-frame-pointer asan_demo.c -o asan_demo预期结果:编译成功时通常不会输出内容,并在当前目录生成可执行文件 asan_demo。如果编译器提示不认识 -fsanitize=address,需要改用支持 ASan 的 GCC 或 Clang 工具链。
分别触发三类错误
依次运行三个模式即可观察不同报告。ASan 默认会让发生内存错误的进程以非零状态结束,因此每一行都是一次独立运行。
./asan_demo overflow
./asan_demo uaf
./asan_demo doublefree预期结果:完整地址、进程号、源码行号和调用栈会随编译器与运行环境变化,但关键诊断类型应分别包含类似下面的内容。
ERROR: AddressSanitizer: heap-buffer-overflow
ERROR: AddressSanitizer: heap-use-after-free
ERROR: AddressSanitizer: attempting double-freeheap-buffer-overflow 表示访问地址越过了堆对象的合法边界;heap-use-after-free 表示目标堆块已经释放却仍被访问;attempting double-free 则说明同一块动态内存进入了第二次释放流程。
按固定顺序读诊断报告
一份 ASan 报告信息很多,但定位时不需要从第一行读到最后一行。先找到 ERROR: AddressSanitizer: 后面的错误类别,确认自己面对的是越界、释放后访问还是释放错误。
接着查看当前非法操作的调用栈。通常最有价值的是第一个属于自己项目源码的栈帧,因为它指出“错误访问发生在哪里”。库函数和 sanitizer 内部栈帧一般不是首先修改的目标。
对于堆内存问题,报告还可能给出相关对象的生命周期信息。例如释放后访问通常能够看到这块内存“在哪里释放”和“最初在哪里分配”的调用栈。把这三个位置放在一起检查,往往可以恢复完整因果链:谁申请、谁释放、谁又继续使用。
| 诊断线索 | 首先回答的问题 |
|---|---|
| 当前访问栈 | 哪一行执行了非法读写或释放 |
| 分配栈 | 这块内存最初由谁创建 |
| 释放栈 | 所有权在哪个位置已经结束 |
| 对象边界说明 | 当前地址相对合法内存区域偏出了多少 |
这种阅读方式比只盯着最终崩溃位置更可靠,因为真正的根因可能发生在更早的所有权转移或释放操作中。
修复后重新验证
对于越界问题,应先检查元素数量、循环终止条件和索引上界;对于释放后访问,应明确释放之后哪些指针仍可能继续被使用;对于重复释放,则要保证一块动态内存在某一时刻只有一个负责释放的所有者。
修复后必须用同一组 sanitizer 编译选项重新构建,并重新执行能够覆盖原错误路径的输入。如果对应路径能够正常结束,同时不再出现 ERROR: AddressSanitizer,才说明这次复现条件下的问题已经消失。
ASan 很适合开发和测试阶段,因为它会增加运行时开销和内存占用,通常不作为生产程序长期启用。它也不能证明程序不存在所有内存问题,但对堆越界、释放后访问和重复释放这类 C 语言错误,通常能把原本随机出现的故障转换成直接指向源码的诊断。