C / C++ / 系统课时
用工具检查项目内存问题
用工具检查项目内存问题
通讯录功能看起来正常,并不代表内存访问一定安全。本节把完整项目重新用 AddressSanitizer 编译,再主动覆盖空数据、容量边界、长输入和反复增删等场景,用工具确认是否存在越界、释放后访问等明显问题。
学习目标
- 为 C 项目开启 AddressSanitizer,并保留便于定位问题的调试信息
- 设计容易触发内存缺陷的通讯录边界场景,而不是只测试正常流程
- 根据 AddressSanitizer 报告定位出错位置,并在修复后重新验证
用 AddressSanitizer 重新构建项目
AddressSanitizer,简称 ASan,会在编译阶段给程序插入额外的内存检查逻辑。运行时一旦发生堆、栈或全局缓冲区越界、释放后继续访问、重复释放等问题,它通常会立即报告错误位置和调用栈。
如果项目目录中的 .c 文件共同组成一个可执行程序,可以使用 GCC 或 Clang 重新编译:
cc -std=c11 -Wall -Wextra -Wpedantic -g -O1 -fsanitize=address -fno-omit-frame-pointer *.c -o contacts_asan预期输出
<NO_OUTPUT>编译成功时通常没有输出,并生成 contacts_asan。如果目录中还包含另一个带 main 函数的测试文件,应把 *.c 换成通讯录实际参与构建的源文件列表。
这里几个选项各有作用:-fsanitize=address 必须同时参与编译和最终链接;-g 保留源码行号;-fno-omit-frame-pointer 让调用栈更容易追踪;-O1 保留一定优化,同时通常比高优化级别更便于排错。
主动覆盖容易出错的边界场景
只执行一次“新增联系人并退出”很难证明程序安全。指针和动态数组的问题通常出现在容量变化、元素移动以及特殊输入附近,因此应按项目实际支持的功能覆盖这些场景:
| 场景 | 重点观察的问题 |
|---|---|
| 通讯录为空时查询、删除、退出 | 是否访问不存在的第 0 个元素或空指针 |
| 只保存 1 个联系人后删除 | 首元素移动与计数是否正确 |
| 添加到当前容量上限 | 最后一个合法下标是否发生越界 |
| 继续添加触发扩容 | realloc 后是否继续使用旧指针 |
| 输入接近字段允许的最大长度 | 字符串末尾是否为终止符,复制是否越界 |
| 删除第一个、中间和最后一个联系人 | 搬移长度与下标计算是否正确 |
| 连续多次添加、删除再添加 | 释放后的指针是否被再次访问 |
| 如果支持文件保存与加载,重复加载和退出 | 旧数据是否先释放,新分配是否完整 |
测试时应通过程序正常提供的菜单或接口触发这些操作,而不是直接修改内部变量。这样检查到的问题才代表真实用户路径。
运行 ASan 版本,并把诊断信息保存下来:
ASAN_OPTIONS=halt_on_error=1 ./contacts_asan 2>asan.log
if grep -Eq "AddressSanitizer|LeakSanitizer" asan.log; then
echo "asan_errors=found"
else
echo "asan_errors=0"
fi在程序运行期间依次完成前面的边界操作,然后正常退出。
预期输出
<PROGRAM_OUTPUT>
asan_errors=0<PROGRAM_OUTPUT> 代表通讯录自身的菜单和业务输出,实际内容会随项目实现和测试数据变化。关键验收结果是最后得到 asan_errors=0,并且程序没有异常终止。
看懂一份典型 ASan 报告
如果出现非法访问,ASan 往往会给出错误种类、访问地址、发生访问的源码位置,以及相关内存最初在哪里分配。例如看到 heap-buffer-overflow 时,应先找到报告中第一个属于自己项目源码的位置,而不是从运行库内部函数开始修改。
一种常见错误是动态数组已经存满,却先写入新元素再扩容。假设容量为 capacity、已有元素数量为 count,合法下标只能到 capacity - 1;当 count == capacity 时再写 contacts[count],写操作本身就已经越界。
修复时应让扩容发生在写入之前,并谨慎处理 realloc 返回值。下面是独立的片段示例,依赖上下文中已经存在 Contact 类型以及 contacts、count、capacity 变量:
if (count == capacity) {
size_t new_capacity = capacity == 0 ? 8 : capacity * 2;
Contact *new_contacts = realloc(contacts, new_capacity * sizeof(*contacts));
/* realloc 失败时,原 contacts 仍然有效,不能直接覆盖后丢失它。 */
if (new_contacts == NULL) {
fprintf(stderr, "memory allocation failed\n");
return 0;
}
contacts = new_contacts;
capacity = new_capacity;
}
contacts[count++] = new_contact;这段代码的生效结果是:只有确认数组存在可用空间后才写入新联系人,并且 realloc 失败不会丢失原来的内存地址。验证方法是重新使用相同 ASan 编译选项构建,再重复“填满容量并继续添加”的场景。
修复后必须重新跑同一组场景
一次没有出现报告,只能说明已经执行到的路径没有被 ASan 检测出明显非法访问。修复某个问题后,应重新编译,而不是继续运行旧的可执行文件,然后完整重复之前触发问题的操作。
rm -f contacts_asan asan.log
cc -std=c11 -Wall -Wextra -Wpedantic -g -O1 -fsanitize=address -fno-omit-frame-pointer *.c -o contacts_asan
ASAN_OPTIONS=halt_on_error=1 ./contacts_asan 2>asan.log预期输出
<PROGRAM_OUTPUT>程序正常退出后,再检查日志中是否出现 ASan 或 LeakSanitizer 报告。实际业务输出可能不同;验收重点是前面列出的边界场景都真实执行过,并且没有再次出现非法内存访问诊断。
ASan 很适合发现实际执行路径上的内存访问错误,但它不能证明所有输入都绝对安全。把它与编译器警告、明确的容量检查、正确的字符串边界处理和系统化边界测试结合起来,才能让动态通讯录从“功能能跑”进一步达到“内存行为可验证”。