WebAssembly反汇编工具：WABT wasm-objdump使用指南

一、工具简介

wasm-objdump是WebAssembly Binary Toolkit（WABT）中的核心工具之一，用于分析和反汇编WebAssembly（Wasm）二进制文件。通过该工具，开发者可以查看Wasm模块的内部结构、指令序列和二进制布局，是Wasm模块调试与逆向分析的重要手段。

官方文档：man/wasm-objdump.1
HTML版手册：docs/doc/wasm-objdump.1.html

二、基础使用方法

2.1 命令格式

wasm-objdump [选项] <Wasm文件路径>

2.2 常用选项说明

选项	全称	功能描述
-h	--headers	显示模块头部信息和段表
-d	--disassemble	反汇编函数体指令
-s	--full-contents	显示段的原始二进制内容
-j	--section=SECTION	仅显示指定段的信息
-x	--details	显示段的详细结构
-r	--reloc	显示重定位信息
--section-offsets	-	使用段内偏移而非文件偏移显示指令地址

三、实战示例

3.1 查看模块基本结构

执行以下命令查看Wasm模块的段表信息：

wasm-objdump -h test.wasm

示例输出包含各段的起始地址、大小和数量：

Sections:
     Type start=0x0000000a end=0x00000011 (size=0x00000007) count: 1
  Function start=0x00000013 end=0x00000015 (size=0x00000002) count: 1
    Memory start=0x00000017 end=0x0000001a (size=0x00000003) count: 1
    Export start=0x0000001c end=0x00000021 (size=0x00000005) count: 1
      Code start=0x00000023 end=0x00000039 (size=0x00000016) count: 1

测试用例参考：test/dump/basic.txt

3.2 反汇编函数指令

使用-d选项反汇编模块中的函数：

wasm-objdump -d test.wasm

输出示例展示函数指令序列：

000025 func[0] <f>:
  000026: 41 00                      | i32.const 0
  000028: 41 00                      | i32.const 0
  00002a: 28 02 00                   | i32.load 2 0
  00002d: 41 01                      | i32.const 1
  00002f: 6a                         | i32.add
  000030: 36 02 00                   | i32.store 2 0
  000033: 20 00                      | local.get 0
  000035: 20 01                      | local.get 1
  000037: 6a                         | i32.add
  000038: 0b                         | end

3.3 查看段原始内容

结合-s选项可查看指定段的十六进制内容：

wasm-objdump -s -j code test.wasm

四、高级应用场景

4.1 分析重定位信息

使用-r选项调试链接问题：

wasm-objdump -dr test.wasm

相关测试用例：test/dump/relocations.txt

4.2 段内偏移地址模式

启用段内偏移显示：

wasm-objdump -d --section-offsets test.wasm

指令地址将显示为相对于段起始的偏移量，便于分析段内布局。

五、工具集成与扩展

5.1 与其他WABT工具配合使用

工具	功能	协作场景
wasm2wat	二进制转文本格式	先反汇编再转Wat分析
wasm-validate	验证模块合法性	调试无效模块时前置检查
wasm-decompile	生成类C伪代码	高级逻辑分析

5.2 自动化测试用例

WABT项目提供了丰富的测试用例，可参考test/dump/目录下的示例，如：

• 内存操作测试：test/dump/memory.txt
• SIMD指令测试：test/dump/simd-basic.txt
• 异常处理测试：test/dump/try.txt

六、常见问题解决

6.1 无法识别自定义段

问题：使用-j指定自定义段时提示不存在。
解决：确保段名拼写正确，可通过-h选项先确认段列表。

6.2 指令地址与源码不匹配

解决：使用--section-offsets选项切换地址模式，或结合wasm2wat -g保留调试信息。

七、总结

wasm-objdump作为WABT工具链的重要组成部分，为WebAssembly模块的底层分析提供了直观高效的解决方案。无论是日常开发调试还是模块逆向工程，灵活运用其各类选项能显著提升问题定位效率。建议结合官方手册和测试用例深入学习，充分发挥工具潜力。

更多高级用法请参考：

• 完整选项说明：man/wasm-objdump.1
• 测试用例库：test/dump/