C / C++ / 系统课时

AddressSanitizer 能查哪些错误

AddressSanitizer 能查哪些错误

很多内存错误不会在写错代码的那一行立刻崩溃,而是稍后才表现成随机异常。AddressSanitizer 会在编译阶段插入内存访问检查,本节通过数组越界和释放后访问两个例子,学习如何启用 ASan、读懂报告并确认问题边界。

学习目标

  • 知道 AddressSanitizer 主要能发现哪些内存访问错误,以及它不能替代哪些检查工具
  • 能用 GCC 或 Clang 为 C 程序启用 ASan,并保留便于定位的调用栈
  • 能从报告中的错误类型、访问方向和分配/释放栈定位根因

ASan 重点检查什么

ASan 擅长发现越界访问和对象生命周期错误,例如堆缓冲区越界、栈缓冲区越界、全局缓冲区越界、释放后访问、重复释放和部分非法释放。它通过给程序内存建立影子状态,并在访问前插入检查,因此只有真正执行到的路径才会被检测。

ASan 插桩与运行时检查流程

它不负责检查所有未定义行为:数据竞争应使用 ThreadSanitizer,未初始化内存读取更适合 MemorySanitizer;整数溢出、非法移位等问题通常由 UndefinedBehaviorSanitizer 补充。ASan 没有报错,只能说明本次执行路径没有触发它能观察到的问题。

准备两个典型错误

下面的完整程序通过命令行参数选择错误类型。overflow 会向两个 int 元素之外写入,uaf 会在 free 之后再次读取同一块堆内存。

c
#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,避免教学示例中的故障代码被优化掉:

bash
gcc -g -O0 -fsanitize=address -fno-omit-frame-pointer \
  -o asan_demo asan_demo.c

预期结果:

text
编译成功并生成可执行文件 asan_demo;正常情况下不会产生编译器输出。

观察堆越界报告

先单独触发越界错误,让一次进程只暴露一种问题,避免后续输出互相干扰:

bash
./asan_demo overflow

预期输出的关键行如下;地址、线程编号和源码行号会因编译器与运行环境不同而变化:

text
ERROR: AddressSanitizer: heap-buffer-overflow
WRITE of size 4
SUMMARY: AddressSanitizer: heap-buffer-overflow

heap-buffer-overflow 说明访问越过了堆对象边界,WRITE of size 4 说明这是一次 4 字节写入。继续向下看报告中的调用栈,应能找到 heap_overflow;再看“allocated by”部分,可以确认这块内存原本只分配给两个 int。

观察释放后访问

再启动一个新进程触发第二类错误:

bash
./asan_demo uaf

预期输出的关键行如下:

text
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 是动态检测工具:没有执行到的分支,仍可能隐藏相同类型的内存错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

AddressSanitizer 能查哪些错误

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

登录哪都通