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。这样每次运行只暴露一种主故障,诊断不会互相遮挡。

c
#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 专门运行未定义行为分支。

bash
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

预期输出(截取关键诊断,地址和源码行号会因环境不同而变化):

text
==<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 只展开确定泄漏的详细信息。

bash
gcc -O0 -g mem_bug.c -o mem_bug_dbg
valgrind --leak-check=full --show-leak-kinds=definite ./mem_bug_dbg leak

预期输出(进程号和调用地址会变化):

text
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 contexts

definitely lost 表示已经没有指针能再释放这块堆内存,应直接修复。若报告的是“未初始化值参与条件判断”,可以再加 --track-origins=yes 追溯值的来源,但它会进一步降低运行速度,不必默认对所有测试开启。

把报告变成修复闭环

本例的修复分别是:把 p[4] 改为合法下标或重新设计容量边界;在相加前做范围检查,或转换到能够容纳结果的更宽类型;在 run_leak 返回前执行 free(p)。修复后必须用同一输入再次运行 Sanitizer 和 Memcheck,而不是以“程序不崩了”作为通过标准。

一个可靠的日常顺序是:先在可复现测试中运行 ASan 与 UBSan,修完第一条真实错误后重跑;再对关键路径使用普通调试构建跑 Memcheck。最终应达到 Sanitizer 无诊断、Memcheck 的错误摘要为 0,并且没有 definitely lost 的泄漏记录。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Sanitizer 与 Valgrind 查内存问题

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

登录哪都通