1 / 4概念
Toolchain: Test and Debug
C 没有内置测试框架,也没有异常栈。质量门由四层拼成:断言与单元测试给出通过或失败,sanitizer 在运行期抓 UB,调试器与动态分析工具回答“为什么”,覆盖率与 fuzz 回答“还有哪里没测到”。读完能在一份最小工程上依次启动这四层,并从报告直接定位到源码行。
1 概念
1.1 一句话定义
C 的测试与调试是一组编译期插桩加运行期观察:测试框架只提供断言与用例注册,sanitizer 由编译器在访问内存、整数与锁的位置插入检查,-g 把类型与行号写进 DWARF,覆盖率由插桩计数器统计,fuzz 用生成的输入驱动同一份二进制。
1.2 它解决什么问题
- UB 静默通过:越界写可能落进分配器的对齐填充,普通测试根本看不见。
- 内存错误延迟暴露:悬空指针与泄漏常在最后一次释放或进程退出时才出问题,现场已经离根因很远。
- 并发缺陷偶发:数据竞争依赖调度,跑一百次不出现不等于没有。
代价是每种插桩都会改变时序与内存布局,工具看到的行为与发布版不完全相同。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 构建规则与 target 组织 | c-make-and-cmake |
| 内存分配与生命周期语义 | c-memory-allocation |
| 线程、原子与内存模型 | c-threads-and-atomics |
返回码、errno 与清理约定 | c-errors-and-resources |
| ABI、符号与装载 | c-object-model-and-abi |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 断言 | 运行期检查表达式,失败即中止 | 不是错误处理机制 |
| 插桩 | 编译器在代码里插入检查或计数器 | 不是链接期包装 |
| 影子内存 | ASan 用来标记每块内存可访问性的元数据 | 不是程序自己的堆 |
| DWARF | 调试信息格式,记录类型、行号与变量位置 | 不是符号表 |
| core dump | 进程崩溃时的内存镜像 | 不是崩溃日志 |
| 覆盖率 | 被执行到的代码比例 | 不等于分支覆盖 |
2 机制
2.1 心智模型
测试是一次受控运行,工具是这次运行的插桩与观察者。 ASan、UBSan、TSan 与覆盖率都在编译期改写代码,gdb、valgrind、perf 与 strace 在运行期观察进程。同一份源码可以生成多个二进制:发布版不带插桩,CI 版带 sanitizer,覆盖率版带计数器;三者的结果不能互相替代。
2.2 机制拆解
assert:来自assert.h,表达式为假时打印文件、行号与表达式并调用abort;定义NDEBUG后整条语句消失。断言不得带副作用,也不得用于校验外部输入,因为发布版里它不存在。- Unity:三个源文件的轻量框架,用
TEST_ASSERT_EQUAL_INT、TEST_ASSERT_NOT_NULL等宏断言,setUp与tearDown做夹具,UNITY_BEGIN、RUN_TEST与UNITY_END组织入口;无动态分配,适合裸机与交叉环境。 - CMocka:在断言之外提供 fixture、
will_return与expect_*做函数级 mock,cmocka_unit_test注册用例;适合需要替换依赖的库测试,代价是多一层库依赖。 - ASan:给每个分配加红区,用 1/8 比例的影子内存记录可访问性;抓堆、栈与全局越界、释放后使用、重复释放。
-fsanitize=address -fno-omit-frame-pointer -g是标准组合,内存开销约 2 倍。 - UBSan:在整数运算、移位、指针解引用与对齐处插入检查;默认只报告并继续,
-fno-sanitize-recover=all让第一个错误中止,便于在 CI 里当门禁。 - TSan:记录每个内存访问的 happens-before 关系,报告没有同步的读写对;内存开销约 5 到 10 倍,且不能与 ASan 同时链接。
- LSan:在进程退出时从根集合扫描可达对象,报告不可达的堆块;Linux 上 ASan 默认集成它,
ASAN_OPTIONS=detect_leaks=1可显式打开。 - gdb 与 lldb:断点、条件断点、watchpoint、
bt、info locals、x/4cb检查内存;崩溃后读 core dump 可还原调用栈,前提是二进制带-g且未被 strip。 - valgrind 与 perf/strace:valgrind 的 memcheck 无需重编即可抓未初始化读与越界,代价是 20 到 50 倍减速;
perf record -g采样 CPU 热点,strace -f -T跟踪系统调用与耗时。 - 覆盖率:GCC 用
--coverage生成.gcno与.gcda,gcov -b -c输出行与分支计数;Clang 用-fprofile-instr-generate -fcoverage-mapping,再经llvm-profdata merge与llvm-cov show渲染。 - fuzz:libFuzzer 用
-fsanitize=fuzzer,address把目标编进二进制,入口是LLVMFuzzerTestOneInput;AFL++ 用afl-clang-fast插桩,afl-fuzz -i in -o out -- ./target @@从语料目录起步。
2.3 完整枚举
本页使用的 sanitizer 共五种,覆盖越界、UB、竞争、泄漏与未初始化五类缺陷:
| sanitizer | 开关 | 抓什么 | 局限 |
|---|---|---|---|
| ASan | -fsanitize=address | 堆/栈/全局越界、UAF、double free、泄漏 | 约 2 倍内存,不能与 TSan 同链 |
| UBSan | -fsanitize=undefined | 有符号溢出、移位越界、空指针、对齐 | 默认只报告,需 -fno-sanitize-recover=all 才中止 |
| TSan | -fsanitize=thread | 数据竞争、锁序、部分死锁 | 5 到 10 倍内存,不能与 ASan 同链 |
| LSan | -fsanitize=leak 或 ASAN_OPTIONS=detect_leaks=1 | 退出时不可达的堆块 | 只查泄漏;全局缓存可能被误报 |
| MSan | -fsanitize=memory(Clang) | 未初始化读 | 依赖库与 libc 都必须插桩 |
3 实践
3.1 最小示例与追踪
示例含一个真实的越界缺陷:malloc(n) 少分配了结尾的 NUL。
/* strdup_upper.h */
#ifndef STRDUP_UPPER_H
#define STRDUP_UPPER_H
char *strdup_upper(const char *s);
#endif
/* strdup_upper.c */
#include <ctype.h>
#include <stdlib.h>
#include <string.h>
#include "strdup_upper.h"
char *strdup_upper(const char *s)
{
size_t n = strlen(s);
char *out = malloc(n); /* 缺陷:应为 n + 1 */
if (out == NULL)
return NULL;
for (size_t i = 0; i <= n; i++)
out[i] = (char)toupper((unsigned char)s[i]);
return out;
}
/* test_strdup_upper.c */
#include <assert.h>
#include <stdlib.h>
#include <string.h>
#include "strdup_upper.h"
int main(void)
{
char *s = strdup_upper("abc");
assert(s != NULL);
assert(strcmp(s, "ABC") == 0);
free(s);
return 0;
}
cc -std=c17 -g -O1 -Wall -Wextra -fsanitize=address,undefined \
-fno-omit-frame-pointer test_strdup_upper.c strdup_upper.c -o test_upper
./test_upper
==4242==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x602000000013
WRITE of size 1 at 0x602000000013 thread T0
#0 0x... in strdup_upper /src/strdup_upper.c:20
0x602000000013 is located 0 bytes after 3-byte region
allocated by thread T0 here:
#0 0x... in malloc
#1 0x... in strdup_upper /src/strdup_upper.c:16
追踪:不带 sanitizer 时 ./test_upper 返回 0,因为第 4 个字节落进 malloc 的对齐填充,断言与 strcmp 都不会发现。ASan 在 3 字节区域后面放红区,写入第 4 字节立即命中;#0 指向写点,allocated by 指向分配点,两者相差四行,正好说明 malloc(n) 少了一个字节。修成 malloc(n + 1) 后重跑,报告消失。把 -fsanitize=address 只加在编译命令、不加在链接命令,会得到 undefined reference to __asan_init;编译与链接必须用同一组 flags。
3.2 选型矩阵
| 项目类型 | 测试框架 | sanitizer | 调试器 | 动态分析 |
|---|---|---|---|---|
| 嵌入式 MCU | Unity | UBSan(资源允许时) | gdb + OpenOCD | 不适用 |
| 通用库 | CMocka 或 Unity | ASan + UBSan,并发部分加 TSan | gdb 或 lldb | valgrind |
| 常驻服务 | 框架加集成测试 | ASan、UBSan、TSan 分三次构建 | gdb 加 core dump | perf |
| 协议解析器 | 表驱动加 fuzz | ASan + UBSan | gdb | 不适用 |
| 内核或驱动 | KUnit | KASAN(内核自带) | kgdb | 不适用 |
3.3 决策规则
- 每个 CI 构建至少跑一次 ASan 与 UBSan;有线程的代码再加一次 TSan,不要试图在一个二进制里同时开 ASan 与 TSan。
- 断言只用于“不可能发生”的内部不变量;外部输入一律用返回码或错误结构校验,因为
NDEBUG会让断言消失。 - 单元测试用
-O0 -g便于定位,性能测试用-O2;两套产物不要混用覆盖率数据。 - 解析、序列化与协议入口应有 fuzz 目标,失败输入落盘后必须提交为回归语料。
- 崩溃先用 core dump 与
bt定位,再上 valgrind 或 sanitizer 复现;不要在没有栈的情况下猜根因。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
ASan 只报 DEADLYSIGNAL,没有源码行 | 缺 -fno-omit-frame-pointer,或栈溢出 | ASAN_OPTIONS=verbosity=1 看映射与线程 | 补 frame pointer,调大 ulimit -s |
链接报 undefined reference to __asan_init | 只在编译命令加了 sanitizer | make V=1 看链接行 | 编译与链接使用同一组 flags |
| ASan 与 TSan 同时开报冲突 | 两种运行时互斥 | 链接器指出重复的运行时符号 | 拆成两个构建分别运行 |
发布版 assert 不触发 | 构建定义了 NDEBUG | cc -dM -E - 查 NDEBUG | 测试构建不定义 NDEBUG |
gdb 没有行号或变量 | 缺 -g,或二进制被 strip | file 显示 stripped | 用 -g -O0 重建并保留副本 |
覆盖率 0% 或找不到 .gcda | 没加 --coverage,或目录不可写 | find . -name '*.gcda' | 补编译开关,或用 GCOV_PREFIX 指定可写目录 |
valgrind 报大量 still reachable | 全局缓存或单例,不是泄漏 | --show-leak-kinds=all 分类 | 只看 definitely lost,其余按设计处理 |
4.2 可观测信号
先读 sanitizer 报告的三段:错误类型与地址、访问栈、分配或释放栈;三者合起来才能区分越界、UAF 与竞态。再用 gdb -batch -ex run -ex bt 或 coredumpctl 取崩溃栈,用 info locals 与 x/ 检查现场。性能侧先 perf record -g 再 perf report 看 flat 与 cumulative,系统调用阻塞用 strace -f -T 确认。覆盖率看 gcov -b -c 的分支行与未执行行,fuzz 看每秒执行数与新增覆盖,两者同时停滞说明语料或种子需要换。
4.3 安全 / 性能 / 一致性边界
- sanitizer 不是证明:它只报告实际执行到的路径;没跑到的分支里的越界不会被发现。
- 插桩改变时序:ASan 与 TSan 会放大内存占用与调度抖动,竞争可能在插桩后消失,也可能因插桩才出现。
- 覆盖率不等于正确性:100% 行覆盖仍可能漏掉所有错误分支;断言与 fuzz 补的是不同维度。
- valgrind 不抓 UB:它抓未初始化与非法访问,不抓有符号溢出或严格别名,后者要靠 UBSan。