iOS 崩溃报告有时会用十六进制地址代替函数名。先找出该栈帧所属应用或框架的构建 UUID,再寻找匹配的 dSYM。版本号和构建号能帮助定位归档,真正决定符号是否匹配的是 UUID。

从一条无法识别的栈帧入手

在崩溃线程中找到来自自己应用的栈帧,再从报告的二进制映像信息中定位它。若缺少的是内嵌框架的符号,就需要该框架的 dSYM。检索前记下二进制名称、架构和 UUID。

核对 UUID 和架构

查看当时用于发布的 Xcode 归档。在归档已被索引的 Mac 上,可以通过 mdfind 查询 com_apple_xcode_dsym_uuids 属性。用 dwarfdump --uuid 检查候选文件,并确认对应架构的 UUID 一致。用同一个提交重新编译也可能产生不同的 UUID。

找回并应用符号文件

让 Xcode 能找到匹配的归档或符号文件,再在相应的崩溃或设备日志视图中打开报告。对比同一个栈帧:如果地址变成函数名,就有了可用的调查线索。如果应用栈帧已解析但框架仍只有地址,就找出该框架,再做一次 UUID 核对。

随发布归档保留符号

下次发布时保留归档和符号,并记录版本号、构建号及提交。例如,117 号构建崩溃时,可以用记录找到原归档,核对 UUID 后重新打开报告。这样即使换一台构建机或由另一位开发者处理,也能重复排查。本文依据 Apple 的 Xcode 文档。
官方参考文档