C / C++ / 系统课时
AddressSanitizer 能查哪些错误
AddressSanitizer 能查哪些错误
很多内存错误不会在写错代码的那一行立刻崩溃,而是稍后才表现成随机异常。AddressSanitizer 会在编译阶段插入内存访问检查,本节通过数组越界和释放后访问两个例子,学习如何启用 ASan、读懂报告并确认问题边界。
学习目标
- 知道 AddressSanitizer 主要能发现哪些内存访问错误,以及它不能替代哪些检查工具
- 能用 GCC 或 Clang 为 C 程序启用 ASan,并保留便于定位的调用栈
- 能从报告中的错误类型、访问方向和分配/释放栈定位根因
ASan 重点检查什么
ASan 擅长发现越界访问和对象生命周期错误,例如堆缓冲区越界、栈缓冲区越界、全局缓冲区越界、释放后访问、重复释放和部分非法释放。它通过给程序内存建立影子状态,并在访问前插入检查,因此只有真正执行到的路径才会被检测。

它不负责检查所有未定义行为:数据竞争应使用 ThreadSanitizer,未初始化内存读取更适合 MemorySanitizer;整数溢出、非法移位等问题通常由 UndefinedBehaviorSanitizer 补充。ASan 没有报错,只能说明本次执行路径没有触发它能观察到的问题。
准备两个典型错误
下面的完整程序通过命令行参数选择错误类型。overflow 会向两个 int 元素之外写入,uaf 会在 free 之后再次读取同一块堆内存。
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
static void heap_overflow(void)
{
int *values = malloc(2 * sizeof(*values));
if (values == NULL) {
exit(EXIT_FAILURE);
}
/* 下标 2 已越过两个元素的有效范围 0..1。 */
values[2] = 42;
free(values);
}
static void use_after_free(void)
{
int *value = malloc(sizeof(*value));
if (value == NULL) {
exit(EXIT_FAILURE);
}
*value = 7;
free(value);
/* 释放后再次读取,生命周期已经结束。 */
printf("%d\n", *value);
}
int main(int argc, char **argv)
{
if (argc != 2) {
fprintf(stderr, "usage: %s overflow|uaf\n", argv[0]);
return EXIT_FAILURE;
}
if (strcmp(argv[1], "overflow") == 0) {
heap_overflow();
} else if (strcmp(argv[1], "uaf") == 0) {
use_after_free();
} else {
fprintf(stderr, "unknown mode: %s\n", argv[1]);
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}使用 GCC 编译时,-fsanitize=address 开启 ASan,-g 保留调试信息,-fno-omit-frame-pointer 让调用栈更容易还原。这里使用 -O0,避免教学示例中的故障代码被优化掉:
gcc -g -O0 -fsanitize=address -fno-omit-frame-pointer \
-o asan_demo asan_demo.c预期结果:
编译成功并生成可执行文件 asan_demo;正常情况下不会产生编译器输出。观察堆越界报告
先单独触发越界错误,让一次进程只暴露一种问题,避免后续输出互相干扰:
./asan_demo overflow预期输出的关键行如下;地址、线程编号和源码行号会因编译器与运行环境不同而变化:
ERROR: AddressSanitizer: heap-buffer-overflow
WRITE of size 4
SUMMARY: AddressSanitizer: heap-buffer-overflowheap-buffer-overflow 说明访问越过了堆对象边界,WRITE of size 4 说明这是一次 4 字节写入。继续向下看报告中的调用栈,应能找到 heap_overflow;再看“allocated by”部分,可以确认这块内存原本只分配给两个 int。
观察释放后访问
再启动一个新进程触发第二类错误:
./asan_demo uaf预期输出的关键行如下:
ERROR: AddressSanitizer: heap-use-after-free
READ of size 4
SUMMARY: AddressSanitizer: heap-use-after-free这次关键词变成 heap-use-after-free 和 READ。ASan 通常还会同时给出“此次非法读取的栈”“该内存被释放时的栈”和“最初分配时的栈”。定位时要把三段信息串起来:谁创建对象、谁结束其生命周期、谁在结束后仍然持有并使用旧指针。
在工程中正确使用
ASan 会增加运行时开销和内存占用,更适合开发、单元测试、集成测试和预发布环境。要获得完整覆盖,相关目标文件应以兼容的 Sanitizer 选项编译,并在最终链接时继续带上 -fsanitize=address;否则一部分代码可能没有被插桩。
修复后应重新运行原来触发问题的输入,确认程序正常退出且输出中不再出现 ERROR: AddressSanitizer。同时扩大测试路径,因为 ASan 是动态检测工具:没有执行到的分支,仍可能隐藏相同类型的内存错误。