ASan 报告怎么看:heap-use-after-free 逐段解读、shadow memory 与栈回溯对齐
更新时间:2026-10-07。短答页。AddressSanitizer(简称 ASan,编译期插桩的内存错误检测器)一报错就是几十行红字,新手常被吓退。其实每份报告结构固定:错误类型一行 + 访问栈 + 分配栈 + 释放栈 + shadow memory 图,按固定顺序读,两分钟就能定位责任代码。本文以最常见的 heap-use-after-free 为例逐段拆。ASan 的编译与原理见 AddressSanitizer 用法。
一句话回答
先读报告第一行 ERROR: AddressSanitizer: <错误类型> 确定是哪类问题;heap-use-after-free 再看 READ/WRITE of size N 那一段的栈顶帧——那是出错时谁在访问;然后把下面 freed by 和 allocated by 两段栈按时间线对齐:谁分配的、谁释放的、谁在释放后还在用,三方里必有一方是 bug 所有者。栈帧全是地址没函数名,先解决符号化再看内容。
一份真实报告的骨架
下面是一份典型的 heap-use-after-free 报告(节选并脱敏):
==12345==ERROR: AddressSanitizer: heap-use-after-free on address 0x6040000000d8
READ of size 4 at 0x6040000000d8 thread T0
#0 0x401234 in Session::touch() src/session.cc:87
#1 0x402567 in Worker::run() src/worker.cc:142
#2 0x403abc in main src/main.cc:33
0x6040000000d8 is located 24 bytes inside of 40-byte region [0x6040000000c0,0x6040000000e8)
freed by thread T0 here:
#0 0x7f1a2b free (.../libasan.so+0x...)
#1 0x404111 in SessionPool::release(Session*) src/pool.cc:55
#2 0x402590 in Worker::run() src/worker.cc:150
previously allocated by thread T0 here:
#0 0x7f1a2a malloc (.../libasan.so+0x...)
#1 0x404321 in SessionPool::acquire() src/pool.cc:31
#2 0x402540 in Worker::run() src/worker.cc:138
SUMMARY: AddressSanitizer: heap-use-after-free src/session.cc:87 in Session::touch()
Shadow bytes around the buggy address:
0x604000000040: fa fa fd fd fd fd fd fd fa fa ...逐段读法:
- 错误类型行(第 1 行):
heap-use-after-free说明访问的是已释放的堆内存。同类常见类型还有heap-buffer-overflow(越界)、stack-use-after-return(用了已返回函数的栈变量)、double-free(重复释放,排查见 double free 排查)。 - 访问栈(
READ of size 4段):出错瞬间的调用栈,栈顶#0是直接动手的那行代码——session.cc:87对this成员做了 4 字节读。注意这行代码本身多半没写错,错的是它拿到的指针已经失效。 - 位置行(
is located 24 bytes inside of 40-byte region):告诉你访问地址落在一个 40 字节块的第 24 字节处,块区间也给出。这个块就是当初acquire()里 malloc 出来的Session对象。 - free 栈:谁释放的——
SessionPool::release(),从worker.cc:150调用进来。 - alloc 栈:谁分配的——
SessionPool::acquire()。 - shadow memory 段(最后):ASan 用影子内存记录每个字节的毒药状态,
fd表示已释放(freed),fa表示 redzone(红区,堆块之间的保护区)。看到访问地址落在fd区,就坐实了 use-after-free。
报告结构图
report: ASan 报告 {
err: 错误类型行\nheap-use-after-free
acc: 访问栈\nREAD of size N\n出错时谁在碰
loc: 位置行\n位于 40 字节块内偏移 24
free: free 栈\n谁释放的
alloc: alloc 栈\n谁分配的
shadow: shadow memory 段\nfd=已释放 fa=redzone
}
who: 责任三方对齐 {
t1: acquire 分配
t2: release 释放
t3: touch 释放后访问
}
report.acc -> who.t3: 栈顶帧
report.free -> who.t2
report.alloc -> who.t1
who.t2 -> who.t3: 时间线上在前的必须晚于访问才合法这张图左边是报告的六个固定段,右边是把三段栈拉成一条时间线后的「责任三方」。解读要点:alloc、free、access 三个栈底往往汇到同一个业务函数(例子里都是 Worker::run()),把这三个点按源码行号排顺序——worker.cc:138 分配、:150 释放、:142 访问——你会发现访问(142)在行号上早于释放(150),但真实执行是循环里先跑了上一轮迭代:行号顺序不等于执行顺序,必须结合循环、回调、异步任务重新推时间线。shadow memory 段的作用是把猜测变成证据:访问地址落在 fd 区域,说明块确实已被 free 回收,不是越界。
常见看不懂的三个坎
坎一:栈帧全是 0x7f... 地址,没有函数名。 这是没符号化。两个条件缺一不可:编译时加 -g(或至少 -gline-tables-only)保留调试信息;运行时让符号化工具可用。GCC/Clang 直接编译的二进制,装 llvm-symbolizer 并设环境变量:
export ASAN_SYMBOLIZER_PATH=$(which llvm-symbolizer)
export ASAN_OPTIONS=symbolize=1:abort_on_error=0C 或静态链接场景可以离线符号化:addr2line -e ./app -f -C 0x401234。动态库地址要减加载基址,细节见 符号与二进制分离。
坎二:栈只有三四帧,看不到业务入口。 ASan 默认回溯深度有限,调大:
export ASAN_OPTIONS=malloc_context_size=30:fast_unwind_on_malloc=0malloc_context_size 控制 alloc/free 栈的帧数;fast_unwind_on_malloc=0 换慢速但更全的回溯,栈被截断时值得开。
坎三:freed by thread T1 here 而访问在 T0——跨线程。 报告里每个栈都标了线程号,T0 访问、T1 释放是经典的「一个线程把对象还给池子,另一个线程还握着裸指针」。这类 bug 单靠 ASan 报的一次现场可能不复现,建议同时跑 ThreadSanitizer 抓数据竞争,竞争修了 use-after-free 往往一起消失。
定位之后怎么修
按「责任三方」对号入座:
- 访问方错了:拿到指针后缓存在成员变量里,对象生命周期却由别人管——改为持有
shared_ptr或加所有权注释,访问前确认 owner 存活。 - 释放方错了:池子
release()后没有通知所有使用者——给池加引用计数,或释放前遍历使用登记。 - 协议错了:双方都没错但缺约定——在代码里明确「谁创建谁销毁」,跨线程交接一律走消息队列而非共享裸指针。
修完别急着关:把 ASAN_OPTIONS=quarantine_size_mb=512 调大隔离区(ASan 默认把释放的内存放进隔离区延迟复用,use-after-free 才抓得住),再跑一遍全量测试确认同类问题没有第二处。
防复发
- CI 里常驻一条 ASan 构建跑单测,比线上 core dump 便宜得多;core dump 分析见 core dump 排查。
- 代码评审时对「裸指针跨函数/跨线程传递」重点把关,能用智能指针就不用裸指针。
- ASan 抓不到的(如自定义内存池内部复用)用 Valgrind Memcheck 交叉验证,两者插桩机制不同,盲区互补。
总结
ASan 报告结构是固定的——错误类型行定性、READ/WRITE 访问栈指出错现场、freed by 和 allocated by 两段栈给出释放者与分配者、shadow memory 段用 fd/fa 毒药字节坐实结论;把三段栈对齐成时间线找出「谁分配、谁释放、谁释放后还在用」的责任三方,符号化不全就先配 llvm-symbolizer 与 ASAN_OPTIONS=symbolize=1,栈太浅就调大 malloc_context_size,照这个顺序读任何一份 ASan 报告都能在几分钟内定位到责任代码。