Go io.ReaderAt 怎样按偏移读取固定记录

处理固定长度二进制文件时，顺序读取不是唯一选择。只要底层对象实现了 io.ReaderAt，就可以根据记录序号直接计算偏移，再把这一条记录读入独立缓冲区。关键不在于“跳到某个位置”，而在于把记录长度、偏移溢出和短读错误一起定义清楚。

官方文档：https://pkg.go.dev/io#ReaderAt

先把记录布局变成偏移公式

假设文件由连续的固定记录组成，每条记录占 recordSize 字节，第 index 条记录从零开始编号，那么起始位置就是 int64(index) * int64(recordSize)。这个公式适合索引表、定长日志和简单二进制归档；它不适合每条记录长度不同、前面还有可变头部的格式。

这里有两个接口边界：索引不能为负，记录长度必须大于零；乘法还不能溢出 int64。如果这一步没有校验，大文件索引越界后可能变成一个看似合法的负偏移。

用 ReaderAt 读取一条固定记录

下面把读取动作收进一个小接口。调用方只需要提供 io.ReaderAt、记录序号和记录长度，不必重复处理偏移计算。示例中的中文注释说明了参数语义、溢出检查和资源错误的传递方式。

package record

import (
    "errors"
    "fmt"
    "io"
    "math"
)

func ReadFixed(r io.ReaderAt, index int64, recordSize int) ([]byte, error) {
    // 索引从零开始，记录长度为零时无法形成有效记录。
    if index  math.MaxInt64/size64 {
        return nil, fmt.Errorf("record offset overflow: index=%d size=%d", index, recordSize)
    }
    offset := index * size64
    buf := make([]byte, recordSize)

    // ReadAt 允许返回部分字节，因此同时保留 n 和 err 做边界判断。
    n, err := r.ReadAt(buf, offset)
    if n == len(buf) {
        return buf, nil
    }
    if err != nil {
        // 到达文件尾但记录只读到一部分时，向上层统一成“记录不完整”。
        if errors.Is(err, io.EOF) {
            return nil, fmt.Errorf("record %d is incomplete: %w", index, io.ErrUnexpectedEOF)
        }
        // 其他错误保留原始原因，方便调用方用 errors.Is/As 继续判断。
        return nil, fmt.Errorf("read record %d: %w", index, err)
    }
    // 对不遵守 ReaderAt 约定的实现做防御性处理，避免静默返回短记录。
    return nil, fmt.Errorf("record %d short read: %w", index, io.ErrUnexpectedEOF)
}

这个函数没有把 io.ReaderAt 强行断言成 *os.File，因此内存文件、映射文件或测试替身都可以接入。若读取成功，返回的切片长度一定等于记录长度；若失败，调用方不会拿到半条记录。

短读、EOF 和底层错误要分开

ReadAt 的返回值要成对阅读：n 说明拿到了多少字节，err 说明为什么停止。完整记录通常是 n == len(buf)；读到文件末尾时可能是零字节加 io.EOF，也可能是部分字节加结束错误。部分记录不能当作成功数据继续解析。

把读取边界放进调用接口

如果记录来自文件，可以直接把打开后的文件传入：

f, err := os.Open("records.bin")
if err != nil {
    return err
}
defer f.Close() // 关闭文件句柄，避免批量读取时持续占用资源

record, err := ReadFixed(f, 12, 64)
if err != nil {
    // 记录不存在与底层故障可以在这里继续分流处理。
    return err
}
_ = record

工程里还应明确索引越界是“没有这条记录”，还是要暴露为数据损坏。建议在业务接口层把 io.ErrUnexpectedEOF 归到格式不完整，把可识别的系统错误继续向上包装；不要为了让调用方省事而把所有错误都改成普通字符串。

相关问题

ReaderAt 和 Reader 最大的区别是什么？

Reader 维护当前位置，适合顺序消费；ReaderAt 每次由调用方传入偏移，适合随机读取，但需要自己维护记录布局。

为什么不能只判断 ReadAt 返回的 error？

因为读取接口同时返回字节数。固定记录场景必须确认 n 达到目标长度，不能把部分数据当作完整记录。

什么时候应该改用变长记录索引？

当记录包含可变文本、压缩内容或不同版本字段时，固定乘法无法得到可靠边界，应先设计长度字段或外部偏移索引。