WAMR 调用栈符号化完全指南:addr2line.py 如何把 iwasm 崩溃调用栈还原为源码行号

原创2026-10-09 15:58:451,915 阅读
文章标签:语言运行时WebAssembly解释器JIT编译编译器嵌入式物联网虚拟化

WAMR 调用栈符号化完全指南:addr2line.py 如何把 iwasm 崩溃调用栈还原为源码行号

导读:当 WebAssembly Micro Runtime (WAMR) 捕获到异常时,会打印形如 #00: 0x0040 - $f0 的调用栈转储,其中只有运行时偏移量与函数编号,无法直接定位问题代码。本文以 WAMR 仓库中的 addr2line.py 工具为核心,系统讲解它如何借助 llvm-symbolizer、llvm-dwarfdump、wasm-objdump、llvm-cxxfilt 四把工具把这类转储还原为"函数名 + 文件:行:列 + 内联调用链",并深入剖析它为绕过 LLVM 在 wasm 目标上的两个知名符号化缺陷而引入的"区间表覆盖"机制。读完本文,你将掌握从抓取调用栈、选择正确的执行模式(interp/aot/fast-interp)到符号化生产级(LTO + wasm-opt + strip)wasm 二进制的完整实战方案。

背景:WAMR 的调用栈转储与符号化的意义

WAMR 在运行时捕获到异常(如 unreachable、越界内存访问、操作数栈溢出)时,会打印出调用栈转储。默认情况下每行只有帧编号、运行时偏移量和函数编号($fN),例如:

#00: 0x0a04 - $f18
#01: 0x08e4 - $f11
#02: 0x096f - $f12
#03: 0x01aa - _start

Exception: unreachable

如果 wasm 文件在编译时携带了调试信息(-g),这些偏移量就可以被映射回源代码位置。这正是 test-tools/addr2line/addr2line.py 的职责:它是一个"薄编排器"(thin orchestrator),自身不做符号解析,而是依次调用四个 LLVM/wabt 工具,并针对 wasm 目标上两个 LLVM 符号化问题内置了规避方案。

在生产环境中,wasm 二进制通常会经过 wasm-opt 裁剪、llvm-strip 剥除调试段以减小体积。此时只要保留一份与之代码布局完全一致的"调试伴生文件"(debug companion),就能用 addr2line.py 离线还原出精确的源码位置。这构成了两个典型工作流:

  • 同二进制(same-binary):直接传入运行时使用的 wasm 文件(必须带 DWARF 调试信息);
  • 伴生文件(companion):传入与线上二进制代码布局完全一致的 .debug.wasm 伴生文件,线上文件本身可以被剥除(详见 samples/debug-tools-optimized/README.md 的构建流水线)。

快速上手:命令与参数

把调用栈转储保存为文本文件(例如 call_stack.txt),然后运行:

python3 addr2line.py \
    --wasi-sdk /opt/wasi-sdk \
    --wabt    /opt/wabt \
    --wasm-file /path/to/app.debug.wasm \
    call_stack.txt

核心参数如下:

参数 默认值 用途
--wasi-sdk <path> (必填) wasi-sdk 安装路径,脚本从中定位 llvm-symbolizer、llvm-dwarfdump、llvm-cxxfilt(要求 wasi-sdk 29 及以上版本,因为 llvm-symbolizer 从该版本起随 SDK 发布)
--wabt <path> (必填) wabt 安装路径,脚本从中定位 wasm-objdump(用于读取 Code 段起始偏移与函数索引→名称表)
--wasm-file <path> (必填) 待符号化的 wasm 文件(必须携带 DWARF 调试信息)
--mode={interp,aot,fast-interp} interp 指定调用栈来自哪种执行模式,决定运行时偏移量如何解释,详见"三种执行模式与三个偏移空间"
--no-addr off 仅按函数名解析(适用于没有偏移量的旧版 iwasm 转储,或 fast-interp 模式)
--emsdk <path> 无 当 wasm 文件含 emscripten sourceMappingURL 段时必填,脚本将改用 emsymbolizer 走 source-map 路径
call_stack_file (位置参数) 调用栈转储文本文件路径

脚本在启动时会校验关键工具的存在性并给出明确报错,例如 wasm-objdump not found at <path>、llvm-symbolizer not found at <path>; need wasi-sdk 29 or newer。

输入行格式(来自源码 parse_call_stack_line)

addr2line.py 中的 parse_call_stack_line 支持三类输入行:

  • 新格式(WAMR > 1.3.2):#00: 0x0a04 - $f18;
  • 旧格式(WAMR <= 1.3.2):#00 $f18(无偏移量,需配合 --no-addr);
  • 文本格式(iwasm 开启 WAMR_BUILD_LOAD_CUSTOM_SECTION=1 与 WAMR_BUILD_CUSTOM_NAME_SECTION=1 时):#02: 0x0200 - a,以及恒定的 #05: 0x011f - _start。

脚本的逐帧处理流程

addr2line.py 对每一帧执行以下 5 步:

  1. 解析每一帧:按 #NN: 0xADDR - SYMBOL 格式提取帧号、偏移量与符号;
  2. 把运行时偏移量换算成 DWARF 地址:WAMR 报告的是文件绝对字节偏移,而 DWARF 地址是相对于 wasm Code 段起始位置的,因此脚本通过 wasm-objdump -h 读取 code_section_start(如 Code start=0x0000017c end=0x00004382 (size=0x00004206) count: 47),执行 offset - code_section_start;
  3. 按执行模式应用调整量:经典解释器模式再减 1,AOT 模式不减(详见下一节);
  4. 解析地址:调用 llvm-symbolizer -e <wasm> -f -i <addr> 获取行号信息与内联链,并把最外层帧的函数名用启动时构建的区间表覆盖(见"区间表覆盖"一节);
  5. 去修饰并渲染:C++ 符号经 llvm-cxxfilt 反修饰;内联帧标注 (inlined into <next>),使调用链自上而下可读。

其中"Code 段起始偏移"由 addr2line.py 的 get_code_section_start() 解析 wasm-objdump -h 输出得到;若找不到 Code 段则向 stderr 报错 Could not find Code section in wasm file 并退出。

三种执行模式,三个偏移空间(--mode)

WAMR 在不同执行模式下捕获 frame_ip 的方式不同,因此转储帧中的偏移量含义也不同。选错 --mode 会把解析器"打进"相邻函数里,静默产生错误的文件/行号,因此这是使用工具时最关键的一步:

模式 偏移空间 调整量 addr2line 做的事
interp(默认) 文件绝对、指令已前进——解释器在陷阱触发前已经把 frame_ip 递增越过触发陷阱的操作码(以及处理器内部 LEB 读取的部分) offset - code_start - 1 完整符号化:文件、行、列、内联链
aot 文件绝对、指令起始处——wamrc 在每个 WASM 操作前发出 commit_ip offset - code_start 完整符号化
fast-interp 函数相对、指向变换后的内存字节码(操作码被替换为处理器索引,LEB 被展开为定宽)——变换破坏了到源码的映射 (无) 仅函数名查找,等价于 --no-addr;每输入一帧输出一帧,无内联展开(DW_TAG_inlined_subroutine 覆盖以地址为键,此处不可用)

注意:--mode=fast-interp 会被脚本内部强制转换为 --no-addr 行为,因为 fast-interp 在加载时于内存中改写了字节码,运行时 ip 指向的是变换后的缓冲区而非原始 wasm 字节,偏移量对源码映射没有意义。

为什么需要"区间表覆盖"(interval-table overlay)

llvm-symbolizer -e <wasm> -f -i <addr> 是"地址 → 函数 + 源码位置"的自然方案,-i 还能展开内联帧。它对行/列信息和内联帧名称是正确的,但最外层帧的函数名会经过两条都可能产生错误结果的路径:

缺陷一:最外层帧的符号表覆盖(LLVM 设计取舍,非 Bug)

llvm-symbolizer 的 symbolizeInlinedCode 在 FunctionNameKind::LinkageName 与 UseSymbolTable 同时成立(这是默认值)时,会无条件地用 getNameFromSymbolTable 的查询结果改写最外层帧的 FunctionName。该覆盖只作用于 getMutableFrame(getNumberOfFrames() - 1),因此内联帧可证明不会被改写。在部分 wasi-sdk / wasm 布局下,符号表对该地址返回了错误函数,尽管 DWARF 本身的定位是正确的。这是 LLVM 的有意设计——因为 -gline-tables-only 构建的 DWARF 里只有行表,此时符号表能提供更好的链接名;代价是在全量 DWARF 的 wasm 构建上会踩坑。

缺陷二:wasm-opt DCE 幽灵 DIE 违反 AddrDieMap 不变量

wasm-opt -Oz -g 会为被死代码消除(DCE)掉的 compiler-rt / libm 辅助函数遗留 low_pc = 0、high_pc 很小(通常 [0, 0) 或 [0, 6),极端可达 [0, 0x80))的 DIE。这是 binaryen DWARF 保留模型的后果:其地址重写 pass 在 src/wasm/wasm-debug.cpp 的 LocationUpdater::getNewFuncStart 中,当旧地址无法映射到任何幸存 IR 节点时返回 0 作为 tombstone,updateDIE 把这个 0 写入 DW_AT_low_pc,却保留 DW_TAG_subprogram 本体(有时连原始 DW_AT_high_pc 也保留)。LLVM DWARFUnit.cpp 的 updateAddressDieMap 假设"子节点在父节点之后插入、每个子节点范围 ⊆ 父节点范围",幽灵 DIE 违反该不变量,导致 map 的 upper_bound − 1 查找返回一个依赖插入顺序的错误 DIE。

经验真值表

对一个小测试模块中 trigger_oob 的内联地址,跨越四种工具链组合实测结果如下:

wasi-sdk wasm-opt -Oz -g symbolizer 最外层 机制
29 (clang 21) 否 free ❌ 符号表覆盖
29 (clang 21) 是 free ❌ 符号表覆盖
33 (clang 22) 否 app_main ✅ 两种机制均未触发
33 (clang 22) 是 fmaf ❌ 一个 [low_pc=0, 0x72) 的 fmaf 幽灵违反 AddrDieMap 不变量

区间表覆盖对以上四种情况全部有效。内层(内联)帧不受影响,因为它们走的是另一条 LLVM 代码路径(getInliningInfoForAddress,从叶子 DIE 沿 getParent() 链接上溯),不经过应用于最外层具体帧的符号表覆盖。

覆盖机制如何工作

脚本在启动时运行一次 llvm-dwarfdump --debug-info,构建一张覆盖每个真实可调用 DW_TAG_subprogram 的内存列表 [(low_pc, high_pc, name), ...](由 build_subprogram_intervals() 实现)。三个跳过守卫保证列表干净:

  • DW_AT_declaration=true → 仅前向声明(如 WASI 导入 __imported_wasi_snapshot_preview1_*)没有代码,排除;
  • low_pc == 0 → 对真实代码结构上不可能(wasm 二进制规范保证 Code 段至少出现在 Type + Function 段头之后),任何 low_pc = 0 的 DIE 都是 wasm-opt DCE 幽灵或损坏的产物;
  • high_pc <= low_pc → 空或退化区间,防御性守卫,在 wasi-sdk 29 与 33 上从未观测到。

对每个捕获到的调用栈地址,lookup_subprogram_name() 返回覆盖该地址的、区间最小的(最内层)幸存 DW_TAG_subprogram——"最内层"很重要,因为 wasi-libc 的声明(low_pc=0、high_pc 横跨大半个二进制)会与真实函数重叠,需要取紧界的那一个。该结果会覆盖 symbolizer 输出中最外层帧的函数名,内层帧名称保持不变。当区间表无覆盖条目时,保留 symbolizer 原本的最外层名称。

依赖的工具矩阵:为什么是这四个

工具 来源 为什么选它
llvm-symbolizer wasi-sdk 真正的"地址 → (函数, 文件:行:列)"解析器,-i 展开内联链。随 wasi-sdk 29+ 发布(项目支持的最低版本)
llvm-dwarfdump wasi-sdk 启动时一次 --debug-info pass 构建每个真实可调用 DW_TAG_subprogram 的 (low_pc, high_pc, name) 区间表,用于覆盖每次解析中最外层帧的函数名。由于上述两个 LLVM 缺陷,直接读取 DWARF 区间可以同时绕过两者;且没有等价 CLI 以结构化输出暴露该查找,因此解析文本
wasm-objdump wabt 报告 Code 段起始偏移(把文件绝对运行时偏移换算为 DWARF 地址必需),以及函数索引→名称表(对仅声明的 DW_TAG_subprogram(如 __main_void)作为兜底回退)
llvm-cxxfilt wasi-sdk C++ 符号反修饰,作为对已解析名称的最终 pass

此外,脚本会检测 emscripten 风格的 sourceMappingURL 自定义段(通过 wasm-objdump -h 输出中是否出现 sourceMappingURL),若存在则回退到 emsymbolizer 走 source-map 路径,此时要求额外提供 --emsdk 参数,且要求 .map 文件与 wasm 文件同目录(脚本用 {wasm_file}.map 拼接路径)。

行为矩阵:输入与解析路径的对应关系

输入 解析路径 输出
--mode=interp 或 --mode=aot,地址在 DWARF 区间内 统一路径 llvm-symbolizer -f -i 提供行信息 + 内联链;最外层帧函数名由启动时构建的区间表覆盖(最内层匹配者胜出)
--mode=fast-interp 函数名 每输入一帧输出一帧,无内联展开,无源码映射
--no-addr 函数名 解析到函数本身——文件:行指向其声明处而非陷阱现场
偏移量为 0 函数名回退(带 (offset=0 — function entry) 注记) 当 WAMR 无法捕获 frame_ip 时使用(如函数入口处陷阱,或 iwasm -f 调用最顶帧)
地址落在任何 DW_TAG_subprogram 之外 wasm-objdump 函数索引表 单个名称;对仅声明的条目有用
源码含 emscripten sourceMappingURL 自定义段 emsymbolizer source-map 路径 每地址单帧;无内联展开(source map 不携带该信息)

关于偏移量为 0 的场景:源码中 offset_int == 0 or offset_int <= code_section_start 时,脚本优雅回退到函数名解析并打印 (offset=0 — function entry, no inline info) 注记,而不是断言崩溃。

输出格式:内联链如何渲染

addr2line.py 的 print_frames() 输出示例(单帧与内联链):

0: c
        at trap.c:4:5
0: do_bad_access (inlined into trigger_oob)
        at oob_access.c:11:5
   trigger_oob (inlined into app_main)
        at oob_main.c:17:5
   app_main
        at oob_main.c:23:5

要点:第一个帧使用 <index>: 前缀,后续帧用等宽空格缩进对齐;除最外层外的每一帧都带 (inlined into <next>) 后缀,明确表达"运行时只看到一个 wasm 帧,但 addr2line.py 从 DWARF 的 DW_TAG_inlined_subroutine 重建了完整源码级调用链"。C++ 符号在渲染前统一经过 llvm-cxxfilt -n 反修饰,确保 _Z... 形式的修饰名绝不泄漏给用户(测试套件专门断言 _ZN 前缀不出现)。

端到端工作流:从抓取调用栈到符号化

最小示例(samples/debug-tools)

仓库提供了完整的端到端示例 samples/debug-tools/README.md。构建侧要求:以 WAMR_BUILD_DUMP_CALL_STACK=1 与 WAMR_BUILD_FAST_INTERP=0 构建 iwasm,wasm 应用用 clang -g 编译(参见该目录下 CMakeLists.txt 与 wasm-apps/CMakeLists.txt 中的 addr2line 相关配置):

$ cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
$ cmake --build build
$ ./build/iwasm build/wasm-apps/trap.wasm

把 stdout 中的调用栈行收集到文件:

$ ./iwasm wasm-apps/trap.wasm | grep "#" > call_stack.txt

AOT 同理,但 wamrc 必须加 --enable-dump-call-stack 选项(见 wasm-apps/CMakeLists.txt):

$ ./iwasm wasm-apps/trap.aot | grep "#" > call_stack.txt

符号化:

$ python3 ../../../test-tools/addr2line/addr2line.py \
    --wasi-sdk /opt/wasi-sdk \
    --wabt /opt/wabt \
    --wasm-file wasm-apps/trap.wasm \
    call_stack.txt

预期输出(节选)中,帧 0 展示了内联展开的实际效果——trap_helper(真正陷阱现场)与其调用者 c 同帧出现:

0: trap_helper (inlined into c)
        at .../samples/debug-tools/wasm-apps/trap.c:9:5
   c
        at .../samples/debug-tools/wasm-apps/trap.c:16:12
1: b
        at .../samples/debug-tools/wasm-apps/trap.c:23:12
...
5: _start
        at wasisdk://.../crt1-command.c:43:13

该示例还附带 verify.py(捕获 .wasm 与 .aot 的调用栈、符号化并断言经典解释器与 AOT 输出均出现内联展开,供 CI 使用),运行方式 python3 verify.py build。注意 verify.py 经 addr2line.py 需要 wasi-sdk >= 29。

生产级工作流(samples/debug-tools-optimized)

针对已发布二进制的调试,samples/debug-tools-optimized/README.md 展示了完整流水线:

clang -Oz -g -flto source1.c source2.c → <name>.wasm        (中间产物)
    └─ wasm-opt -Oz -g → <name>.debug.wasm                  (伴生文件: 代码 + DWARF + names)
        └─ llvm-strip --strip-all → <name>.prod.wasm        (生产文件: 仅代码)

三个关键设计决策:

  • 生产文件由伴生文件派生,而非独立流水线:wasm-opt -Oz(不带 -g)与 wasm-opt -Oz -g 产生结构不同的二进制(-g 会抑制部分内联 pass 以保全 DWARF 完整性)。若分开跑,生产文件的代码偏移将与伴生文件 DWARF 地址空间不匹配,离线解码会静默失败。相反,只跑一次 wasm-opt -Oz -g,再对伴生文件执行 llvm-strip --strip-all 得到生产文件。自定义段(DWARF、names)在 wasm 二进制格式中位于 Code 段之后,剥除它们不会移动代码偏移,从而保证生产与伴生文件代码逐字节一致。
  • -flto 的必要性:无 LTO 时,不同 .c 文件中的函数即使 -Oz 也保持为独立 wasm 函数;有了 LTO,编译器把全部源码视为一个单元、跨文件激进内联,这正是 do_bad_access → trigger_oob → app_main 链塌缩为单个 wasm 函数并携带多个 DW_TAG_inlined_subroutine 的原因。
  • recurse() 刻意非尾递归:int r = recurse(depth + 1); return r + buf[0]; 而非 return recurse(depth + 1);——尾调用在 -Oz -flto 下会被转成循环从而消除递归,非尾形式强制真实 call 指令,每层迭代都压新帧。

示例验证命令(verify.py <app> <wasm|aot> [build-dir]):

cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
cmake --build build
cd build
python3 ../verify.py oob wasm build
python3 ../verify.py oob aot build
python3 ../verify.py stackoverflow wasm build
python3 ../verify.py stackoverflow aot build

以 USE_FAST_INTERP=ON 构建时,verify.py 会自动检测 iwasm 使用的是经典解释器还是 fast-interp(通过检查二进制中是否存在 wasm_interp_fast.c 符号),并传入正确的 --mode。

AOT 侧注意:wamrc --enable-dump-call-stack --bounds-checks=1 中 --bounds-checks=1 强制软件内存越界检查而非硬件陷阱,使 OOB 异常走运行时异常路径(捕获 frame_ip)而非 SIGSEGV(绕过 ip 捕获);解释器侧同理,需要 WAMR_DISABLE_HW_BOUND_CHECK=1。这就是示例中 OOB 崩溃仍能拿到完整调用栈的原因。

测试与验证:pytest 套件

测试套件位于 test-tools/addr2line/tests/,由 tests/README.md 与 test_addr2line.py 组成。每个用例聚焦 addr2line.py 的一个特定方面:

测试 源码 目的
test_build_subprogram_intervals_filters_invalid_dies apps/simple.c(+ wasm-opt 后处理) 触发 DCE-幽灵模式,断言区间表不含 low_pc = 0 与 high_pc <= low_pc 条目
test_simple_resolution apps/simple.c 基线:单函数单陷阱,断言解析到函数名与其源文件
test_inline_chain_basic apps/always_inline.c always_inline 辅助函数处的陷阱产生 2 帧内联链,断言两个名字与 (inlined into <next>) 注记
test_inline_chain_deep apps/deep_inline_chain.c 四层嵌套 always-inline 在 -O0 -g 下塌缩为一个 wasm 函数,断言四层全部渲染且最外层为 app_main(而非与 app_main PC 区间重叠的 wasi-libc 符号如 __multi3)——这是捕获 "(inlined into free)" / wasi-libc 阴影类回归的关键用例
test_cross_tu_inline apps/multi_file_recur_*.c 两个 TU、-Oz -flto 加 wasm-opt -Oz -g——两种最外层失败模式的经典触发器。测试只钉住受限契约:行表必须落在本项目源码内(或返回 ??:0),绝不进入 wasi-libc / wasi-sysroot
test_trap_mid_function apps/trap_in_loop.c 陷阱在循环体内、距函数入口若干指令,断言解析行号 > 10(非函数声明行),防止地址被塌缩回函数入口
test_multi_frame_callstack apps/multi_frame.c 四个独立 wasm 函数的调用链,断言每帧名称与帧索引正确
test_cxx_demangling apps/cxx_mangled.cpp 模板 + 命名空间的 C++ 函数,断言 _Z... 修饰名不泄漏、行表解析到本项目 .cpp
test_aot_mode apps/simple.c(-Oz -g) --mode=aot 不做 -1 调整(wamrc 在指令起始处提交 ip),断言 low_pc+delta 处的地址仍正确解析;crash() 在 -Oz 下被内联掉时跳过
test_fast_interp_mode fixtures/fast_interp_stack.txt + apps/simple.c 夹具含 $f0/$f1 索引,--mode=fast-interp 强制函数名查找,断言解析到 crash/app_main
test_no_addr_mode 同夹具 --no-addr 的显式函数名查找,额外断言 DWARF 声明文件 simple.c 被呈现
test_offset_zero_fallback apps/simple.c 偏移量 0 时优雅回退到函数名解析,不崩溃、不断言
test_empty_input fixtures/empty_stack.txt 空调用栈干净退出(rc=0)且无输出,防御 IndexError 类崩溃

运行方式:

# 默认:针对 $WASI_SDK_PATH 或 /opt/wasi-sdk
./run_tests.sh
# 或
python3 -m pytest -v

# 仅夹具(快,无需构建)
./run_tests.sh -m "not slow"

# 多 SDK:对检测到的每个 /opt/wasi-sdk-*-x86_64-linux 安装参数化构建类测试
./run_tests.sh --multi-sdk

# 详细模式:打印每个测试的 addr2line 输入与 stdout/stderr
./run_tests.sh -v -s

多 SDK CI(--multi-sdk)会分别用 wasi-sdk 29(clang 21)与 wasi-sdk 33(clang 22)产生的 DWARF 反复锤炼解析器,以捕获不同 clang 版本间的 DIE 编码差异。

前置依赖:如何让 iwasm 吐出调用栈

要让 addr2line.py 有输入可用,运行时的构建配置同样关键。参见 doc/build_wamr.md 中 "dump call stack feature" 一节:

  • WAMR_BUILD_DUMP_CALL_STACK=1/0,默认 off。开启后运行时在异常时打印调用栈。
  • 函数名来源:解释器模式下优先取自定义 name 段;该段缺失或被禁用时,退而取 import/export 段。AOT/JIT 模式下名称来自 import/export 段,因此尽量导出更多函数(wasi-sdk 可用 -Wl,--export-all),并在编译 AOT 模块时给 wamrc 加 --enable-dump-call-stack --emit-custom-sections=name。
  • AOT 调用栈:编译 AOT 模块需加 --enable-dump-call-stack;WAMR_BUILD_AOT_STACK_FRAME 开启后,AOT/JIT 会在调用时构建类似经典解释器的栈帧(但只存必要信息)。

与调试相关的另一能力是 wasm_runtime_dump_call_stack_to_buf()(见 doc/build_wamr.md 中对应的内存调试章节):它不像 dump call stack 特性那样在异常时打印,而是允许嵌入方以编程方式把调用栈拷入缓冲区。底层实现在 core/iwasm/interpreter/wasm_runtime.c 的 wasm_interp_dump_call_stack()。

局限与边界

  • --no-addr / fast-interp 模式:get_line_info_from_function_name_dwarf() 通过 llvm-dwarfdump --name=<func> 手动解析文本得到的是函数的声明行,而非陷阱现场;llvm-symbolizer 是地址驱动的、没有"按名查源码"模式,这是当前实现的已知 TODO 局限(源码注释建议未来可用 pyelftools 之类的编程式 DWARF 读取器替代)。
  • 内联展开依赖 DWARF 元数据:内联展开是自动的、不需要开关,但前提是二进制 DWARF 中确实携带 DW_TAG_inlined_subroutine(即编译时用 -O2/-Oz 或 always_inline 产生内联)。
  • source-map 路径无内联展开:emscripten source map 不携带内联信息,每个地址只输出单帧。
  • 版本前提:llvm-symbolizer 需要 wasi-sdk 29+;wabt 提供 wasm-objdump。

小结

addr2line.py 表面上是一个不到八百行的 Python 脚本,却完整覆盖了"解析转储 → 偏移空间换算 → DWARF 地址解析 → 内联链重建 → 反修饰渲染"的全链路,并针对 LLVM 在 wasm 目标上最外层函数名的两类缺陷(符号表覆盖设计取舍、binaryen DCE 幽灵 DIE 违反 AddrDieMap 不变量)提供了可验证的修复方案。配合 samples/debug-tools 与 samples/debug-tools-optimized 两个示例、pytest 测试套件 以及 doc/build_wamr.md 中的 WAMR_BUILD_DUMP_CALL_STACK 配置,读者可以在开发构建与生产优化二进制两种场景下,稳定地把 WAMR 崩溃调用栈还原为可读的源码级诊断信息。

登录后查看全文
wasm-micro-runtime