Go debug/dwarf SeekPC 为什么找不到某些地址

用 debug/dwarf 做 Go 崩溃地址或符号定位时，SeekPC 返回 ErrUnknownPC，不一定是 DWARF 损坏。最常见的原因是查错了对象，或者传入的 PC 和调试信息使用的地址不在同一个空间。

官方地址：https://pkg.go.dev/debug/dwarf

先记住一句话：Reader.SeekPC 查“哪个编译单元覆盖这个地址”，LineReader.SeekPC 查“哪一行表记录覆盖这个地址”。先确认使用的是哪一个，再检查地址是否落在对应范围内；收到 ErrUnknownPC 后不要继续使用 reader 的位置。

先分清两个 SeekPC 查的是什么

Reader.SeekPC(pc) 返回包含该地址的编译单元，并把 reader 放到读取该单元子节点的位置。它适合先判断 DWARF info 中有没有覆盖这个 PC 的 compilation unit。LineReader.SeekPC(pc, entry) 面向某个编译单元的行表，命中后填充 LineEntry，并把 reader 定位到下一条记录。

所以排查时先问自己：我手里的是一个想找源文件行号的 PC，还是已经拿到编译单元后继续查行表？如果跳过第一层，直接对错误的行表调用 SeekPC，自然会得到未覆盖结果。

地址不在同一空间时，SeekPC 一定找不到

DWARF 中的地址要和查询值可比较。把进程日志里的运行时地址直接拿去查文件中的调试信息，常见问题包括 PIE/共享对象的加载基址没有处理、地址来自另一个模块，或者日志记录的是返回地址而不是当前指令地址。

func lookupLine(lr *dwarf.LineReader, pc uint64) (*dwarf.LineEntry, error) {
    var entry dwarf.LineEntry
    if err := lr.SeekPC(pc, &entry); err != nil {
        // ErrUnknownPC 代表行表没有覆盖该值，失败后的 reader 位置不可依赖。
        if errors.Is(err, dwarf.ErrUnknownPC) {
            return nil, fmt.Errorf("PC %#x 不在当前行表范围：%w", pc, err)
        }
        return nil, err
    }
    // 命中后 entry 里的文件索引、行号和地址才可继续使用。
    return &entry, nil
}

排查地址时可以按这个顺序记录：PC 的来源、所属模块、模块加载基址、DWARF 文件对应的链接地址，以及是否来自调用指令的返回地址。只有在明确知道采集点语义时，才尝试对返回地址做 pc-1 修正；它不是所有 PC 的通用修复。

ErrUnknownPC 还可能说明调试范围本来就不完整

编译单元可以描述可执行文件中的多个区域，行表也不保证覆盖每一个机器地址。优化、内联、汇编入口、跳板代码或没有行信息的区域，都可能让一个真实存在的 PC 没有对应行记录。此时不要把“没有行号”误判成“地址非法”。

可以先用 Reader.SeekPC 判断编译单元是否覆盖，再取该单元的 LineReader 查询行表。前者命中而后者失败，排查重点就是行表覆盖或当前 PC 的边界；两者都失败，优先回到模块和地址空间检查。

重复查询用范围索引，不要反复盲扫

官方文档说明，LineReader 的表只允许顺序向前扫描，最坏情况下单次 SeekPC 会线性走过大量记录；Reader.SeekPC 也可能搜索所有编译单元的范围。重复处理崩溃地址时，先通过 Data.Ranges 取得范围，再构建按起始地址排序的索引，把查询缩小到候选编译单元。

一份不容易走偏的排查清单

1. 确认调用的是 Reader.SeekPC 还是 LineReader.SeekPC。
2. 打印 PC 来源和模块，核对加载基址与文件地址的换算。
3. 用 errors.Is(err, dwarf.ErrUnknownPC) 区分“未覆盖”与解析错误。
4. 失败后丢弃当前 reader 位置，重新定位或重新创建读取流程。
5. 批量查询时使用 Ranges，并让 PC 尽量按升序进入查询。

这样处理后，ErrUnknownPC 就从一个模糊的“找不到地址”，变成了可定位的范围问题：是编译单元没覆盖、行表没覆盖、地址还没校正，还是查询层级选错。

相关问题

Reader.SeekPC 和 LineReader.SeekPC 可以互相替代吗？

不能。前者找编译单元，后者在一个编译单元的行表中找行记录，输入准备和失败后的处理也不同。

ErrUnknownPC 返回后还能继续调用 Next 吗？

不应依赖。官方文档明确说失败时 reader 的最终位置未定义，应重新定位或重新建立读取状态。

为什么地址看起来属于函数，却没有源代码行？

函数范围和行表范围不是同一份信息；优化、内联、汇编或没有行记录的地址都可能只有前者命中。