Go os.File.ReadAt 返回 EOF 时怎么判断数据完整：n 与 err 的组合语义

用 os.File.ReadAt 读取文件头、定长记录或二进制协议时，最容易误判的地方是：看到 io.EOF 就认为读取失败，或者只判断 err == nil 就认为数据完整。真正应该先看返回的 n 是否等于目标缓冲区长度，再结合 err 判断是完整数据、短读还是偏移错误。

先看 n：固定长度读取是否真的完成

假设文件头部有 16 字节，代码准备了一个 16 字节缓冲区。判断结果时，第一层条件应是 n == len(header)。因为调用方要的是完整的 16 字节，而不是“系统曾经返回过一些字节”。

header := make([]byte, 16)
n, err := f.ReadAt(header, 0)
if n != len(header) {
    return fmt.Errorf("short header: got %d, want %d: %w", n, len(header), err)
}
if err != nil {
    return fmt.Errorf("read header: %w", err)
}

对普通文件来说，完整填充缓冲区时通常可以得到 err == nil。但接口契约的核心仍是返回字节数和错误一起看：n 说明拿到了多少，err 说明这次调用是否遇到边界或底层问题。

为什么短读时一定要处理 io.EOF

os.File.ReadAt 的文档明确规定：当 n

这里不要写成“遇到 EOF 就重试”。文件尾是稳定边界，重试不会凭空生成缺失字节。只有当文件可能仍在增长，并且业务明确允许等待后再次读取时，才应把重试作为上层策略，而不是把它当作 ReadAt 的默认语义。

把 n 和 err 写成可复用的判断函数

读取定长块时，可以把“完整、短读、其他错误”集中到一个小函数里。这样业务层不会在不同文件解析器里各写一套不一致的判断。

func readFullAt(f *os.File, buf []byte, off int64) error {
    n, err := f.ReadAt(buf, off)
    switch {
    case n == len(buf) && err == nil:
        return nil
    case n 

把文件尾转换为 io.ErrUnexpectedEOF 是上层语义：它表示协议记录不完整，比直接把 io.EOF 往外传更容易让调用方区分“正常读到文件末尾”和“记录被截断”。

三个容易踩坑的边界

空缓冲区不代表读到了文件

当 len(buf) == 0 时，调用没有要读取的字节。不要用这种调用去探测文件是否存在内容；要判断文件长度，应使用 Stat，要验证某个区间是否可读，则传入实际需要的长度。

负偏移是参数错误，不是 EOF

off

ReadAt 不改变当前文件偏移

ReadAt 使用给定的字节偏移读取，不依赖 Seek 后的共享游标。多个 goroutine 读取不同区间时，这个特性可以减少游标互相覆盖的风险；但文件仍可能被其他协程截断或替换，解析前后仍需遵守自己的文件生命周期约束。

用一个最小测试把结果钉住

测试时不要只覆盖“文件足够长”的成功分支，再补一个比目标记录短的临时文件，直接断言字节数、errors.Is 和上层转换后的错误。

func TestReadFullAtShortFile(t *testing.T) {
    name := filepath.Join(t.TempDir(), "record.bin")
    if err := os.WriteFile(name, []byte("abc"), 0o600); err != nil {
        t.Fatal(err)
    }

    f, err := os.Open(name)
    if err != nil {
        t.Fatal(err)
    }
    defer f.Close()

    buf := make([]byte, 8)
    n, err := f.ReadAt(buf, 0)
    if n != 3 || !errors.Is(err, io.EOF) {
        t.Fatalf("ReadAt() = (%d, %v), want (3, io.EOF)", n, err)
    }
}

这类测试的价值在于把接口事实固定下来：文件只有 3 字节时，8 字节读取不会默默返回一个“看起来可解析”的缓冲区。解析器必须先检查 n，再决定是否接受内容。

相关问题

ReadAt 返回 n == len(buf) 但 err 不为 nil 怎么办？

先保留错误并记录具体类型，不要无条件忽略。对固定长度协议，完整字节数说明数据区已经填满，但非 nil 错误仍可能代表底层或包装层异常。

读取整个文件是否应该自己循环 ReadAt？

如果目标就是整个文件，优先使用 os.ReadFile 或明确的流式读取逻辑。ReadAt 更适合已知偏移和固定区间的读取。

io.EOF 和 io.ErrUnexpectedEOF 有什么区别？

io.EOF 表示输入到达末尾；当一个本应完整的记录只拿到一部分时，上层通常转换为 io.ErrUnexpectedEOF，让调用方知道这是截断。

最后的判断顺序

处理定长 ReadAt 时，可以记住一个顺序：先比较 n 与目标长度，再用 errors.Is(err, io.EOF) 识别文件尾，最后对负偏移、关闭文件和系统错误做单独分类。这样既不会把合法的完整读取误判成失败，也不会把短读当成成功数据交给后续解析。