C / C++ / 系统课时

用 AddressSanitizer 查内存错误

用 AddressSanitizer 查内存错误

越界、释放后访问和重复释放往往不会在出错语句处立即表现为崩溃。AddressSanitizer 会在编译阶段插入检查,并在运行时报告非法内存访问。本课用一个可复现实验掌握启用方式、错误类型和诊断信息的阅读顺序。

学习目标

  • 使用 GCC 或 Clang 为 C 程序启用 AddressSanitizer
  • 识别越界、释放后访问和重复释放的关键诊断名称
  • 根据访问位置、分配位置和释放位置回到源码定位根因

编译时启用 AddressSanitizer

AddressSanitizer 通常简称 ASan。使用 GCC 或 Clang 时,核心选项是 -fsanitize=address。调试阶段还建议保留调试信息和栈帧,使报告中的调用栈更容易对应到源码。

下面创建一个实验程序,通过命令行参数选择三种典型错误。每次运行只触发一种错误,避免第一个异常终止后遮住其他问题。

c
#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 则保留基本优化同时方便调试。

bash
cc -g -O1 -fsanitize=address -fno-omit-frame-pointer asan_demo.c -o asan_demo

预期结果:编译成功时通常不会输出内容,并在当前目录生成可执行文件 asan_demo。如果编译器提示不认识 -fsanitize=address,需要改用支持 ASan 的 GCC 或 Clang 工具链。

分别触发三类错误

依次运行三个模式即可观察不同报告。ASan 默认会让发生内存错误的进程以非零状态结束,因此每一行都是一次独立运行。

bash
./asan_demo overflow
./asan_demo uaf
./asan_demo doublefree

预期结果:完整地址、进程号、源码行号和调用栈会随编译器与运行环境变化,但关键诊断类型应分别包含类似下面的内容。

text
ERROR: AddressSanitizer: heap-buffer-overflow
ERROR: AddressSanitizer: heap-use-after-free
ERROR: AddressSanitizer: attempting double-free

heap-buffer-overflow 表示访问地址越过了堆对象的合法边界;heap-use-after-free 表示目标堆块已经释放却仍被访问;attempting double-free 则说明同一块动态内存进入了第二次释放流程。

按固定顺序读诊断报告

一份 ASan 报告信息很多,但定位时不需要从第一行读到最后一行。先找到 ERROR: AddressSanitizer: 后面的错误类别,确认自己面对的是越界、释放后访问还是释放错误。

接着查看当前非法操作的调用栈。通常最有价值的是第一个属于自己项目源码的栈帧,因为它指出“错误访问发生在哪里”。库函数和 sanitizer 内部栈帧一般不是首先修改的目标。

对于堆内存问题,报告还可能给出相关对象的生命周期信息。例如释放后访问通常能够看到这块内存“在哪里释放”和“最初在哪里分配”的调用栈。把这三个位置放在一起检查,往往可以恢复完整因果链:谁申请、谁释放、谁又继续使用。

诊断线索 首先回答的问题
当前访问栈 哪一行执行了非法读写或释放
分配栈 这块内存最初由谁创建
释放栈 所有权在哪个位置已经结束
对象边界说明 当前地址相对合法内存区域偏出了多少

这种阅读方式比只盯着最终崩溃位置更可靠,因为真正的根因可能发生在更早的所有权转移或释放操作中。

修复后重新验证

对于越界问题,应先检查元素数量、循环终止条件和索引上界;对于释放后访问,应明确释放之后哪些指针仍可能继续被使用;对于重复释放,则要保证一块动态内存在某一时刻只有一个负责释放的所有者。

修复后必须用同一组 sanitizer 编译选项重新构建,并重新执行能够覆盖原错误路径的输入。如果对应路径能够正常结束,同时不再出现 ERROR: AddressSanitizer,才说明这次复现条件下的问题已经消失。

ASan 很适合开发和测试阶段,因为它会增加运行时开销和内存占用,通常不作为生产程序长期启用。它也不能证明程序不存在所有内存问题,但对堆越界、释放后访问和重复释放这类 C 语言错误,通常能把原本随机出现的故障转换成直接指向源码的诊断。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 AddressSanitizer 查内存错误

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

登录哪都通