perf 报告全是地址不显示函数名怎么办?
更新时间:2026-10-07。短答页。
perf report里一列0x7f3a2c1b84f0或[unknown],说明「采样到的指令地址 → 函数名」这条解析链断了。perf 只记录地址,翻译工作发生在 report 阶段,断点几乎总在这四类:符号被 strip、没装 debuginfo、调用栈采集方式不对、运行环境和分析环境不是同一个文件系统。
一句话回答
先用 perf report --stdio 确认地址落在哪个模块(可执行文件、.so、内核还是 [JIT]),然后对号入座:二进制被 strip 就装对应 debuginfo 包或换未 strip 的构建;调用栈全是 [unknown] 多半是采样时没加 --call-graph dwarf;容器里抓的 perf.data 拷到宿主机分析,要用 perf buildid-cache 把容器内的二进制和符号喂给缓存。
符号是怎么从地址变回来的
perf 采样时只记录两件事:指令指针(IP,CPU 正在执行的那条指令地址)和进程当时的内存映射(/proc/<pid>/maps 的快照)。分析阶段 perf report 拿地址减去映射基址得到文件内偏移,再查二进制的符号表(symbol table,记录「函数名 ↔ 地址范围」的段)得到函数名。链路上任何一环缺失,输出就退化成裸地址。
读这张图的重点:地址翻译不是一次查找而是两段——先靠内存映射找到「这个地址属于哪个文件」,再靠那个文件的符号表找到「文件内这个偏移是哪个函数」。第一段断了会显示 [unknown](连属于谁都不知道),第二段断了会显示 二进制名 + 0x偏移(知道文件但没名字)。两种症状对应的原因不同,先分清再下药。
原因分类与对号入座
| 报告里的长相 | 断在哪 | 典型原因 |
|---|---|---|
[unknown] 整行 | 找不到所属模块 | 调用栈没采到 / JIT 代码 / maps 丢失 |
libc-2.31.so + 0x240b3 | 模块有、符号没有 | 二进制被 strip,缺 debuginfo |
| 只有顶层有名字、下面全是地址 | 栈展开失败 | 没加 --call-graph dwarf,且程序编译时省略了帧指针 |
容器内进程全是 [unknown] | 分析环境找不到文件 | 在宿主机 report 容器里采的 perf.data |
排查与解决
第一类:二进制被 strip(最常见)。 发布构建常用 strip 或 -s 链接选项把 .symtab 段削掉减体积,内联符号表没了,只剩动态符号(.dynsym),静态函数全部变地址。确认方法:
file ./myapp # 看输出里有没有 "stripped"
nm ./myapp | head # 没输出说明 symtab 被削
readelf -S ./myapp | grep -E "symtab|debug" # 看还剩哪些符号段解法按优先级:① 用没 strip 的同版本构建重跑一次;② 发行版官方包装对应 debuginfo 包——CentOS/RHEL 用 debuginfo-install glibc,Ubuntu 用 apt install libc6-dbg,perf 会自动去 /usr/lib/debug 找;③ 自己编译的项目保留一份带符号的副本,把 perf.data 和有符号的二进制放同一台机器分析。符号表机制的细节见 符号表。
第二类:调用栈全是 [unknown]。 症状是热点函数本身有名字,但展开调用栈全是 unknown 或只有一两帧。原因:perf 默认用帧指针(frame pointer,FP,每个函数栈帧里保存的返回链)回溯,而 -O2 编译默认 -fomit-frame-pointer 把这个优化掉了。解法不用重编程序——采样时改用 DWARF(Debugging With Attributed Record Formats,编译器生成的调试信息格式,perf 用它做离线栈展开):
perf record -g --call-graph dwarf,65528 -p <pid> -- sleep 30注意把栈快照调大(默认 8192 字节容易截断,65528 是常见上限)。代价是 perf.data 体积明显变大,这是正常的。perf 采样与报告的完整用法见 perf record/report 与火焰图 和 perf 命令。
第三类:容器/跨机分析。 perf.data 里存的是二进制路径 + build-id(编译时嵌入 ELF 的唯一标识),report 时按它去当前文件系统找文件。容器里采的数据拿到宿主机分析,路径 /usr/bin/myapp 指向的是宿主机的文件,符号自然对不上。解法:在容器内(或把容器内二进制拷出来后)喂给缓存:
perf buildid-cache --add /path/to/myapp # 按 build-id 登记到 ~/.debug
perf report --kallsyms /path/to/kallsyms # 内核符号缺失时单独指定第四类:JIT 与解释型语言。 JVM、V8 这类即时编译(JIT)运行时的代码是运行时生成的,磁盘上根本没有对应文件,perf 只能给地址。Java 要配合 perf-map-agent 生成 /tmp/perf-<pid>.map;.so 插件自己 dlopen 的也要确认它没 strip。
防复发
- 发布流水线保留一份未 strip 的符号包(或
objcopy --only-keep-debug抽出的.debug文件),按版本归档,事故时perf buildid-cache --add即用。 - 采样命令固化成脚本,
-g --call-graph dwarf作为默认参数,不要现场凭记忆敲。 - 容器环境把 perf 分析也放进容器做,或挂载宿主机的
~/.debug目录。 - 编译选项上,
-g(生成 debuginfo)对性能几乎零影响,release 构建也建议带上;-fno-omit-frame-pointer在性能敏感场景可不加,但要知道代价是 dwarf 栈展开。ELF 各段干什么见 ELF 格式。
总结
perf 报告全是地址是「地址 → 模块 → 符号表 → 函数名」链路断了的信号:整行 [unknown] 查调用栈采集(加 --call-graph dwarf)和 JIT 场景,模块名加十六进制偏移查 strip 与 debuginfo(装 debug 包或换带符号构建),容器数据换机分析用 perf buildid-cache 按 build-id 登记符号——先看清报告里地址长什么样,再决定修哪一环。