Go os.File ReadAt 能否并发调用：偏移量独立与短读处理

如果一个大文件要被多个 goroutine 分段读取，os.File.ReadAt 可以让它们共享同一个文件句柄，只要每次调用使用各自的 off 和缓冲区。它不会像 Read 那样依赖共享文件游标；不过读取范围接近文件尾部时，仍必须同时检查返回的 n 和 err。

可以并发调用同一个 os.File 的 ReadAt，关键是偏移量、缓冲区和生命周期各自独立；当 n 时，不要把部分数据当成完整块。

ReadAt 为什么适合按块并发读

线上做文件摘要或分块上传时，最容易误用的是把同一个 *os.File 交给多个 goroutine，然后都调用 Read。Read 会推进文件的当前偏移，谁先拿到句柄谁就可能改变下一次读取位置，结果很难按块复现。

ReadAt 的调用链更直接：调用者给出 off，ReadAt 再进入底层的按偏移读取。下面这段代码让第 0、1、2 块分别读取不同区间，返回结果按 block 写回，而不是让 goroutine 争抢同一块内存。

type chunk struct {
    block int
    data  []byte
}

func readChunk(f *os.File, block int, size int64) (chunk, error) {
    buf := make([]byte, size)
    off := int64(block) * size
    n, err := f.ReadAt(buf, off)
    if err != nil && err != io.EOF {
        return chunk{}, err
    }
    return chunk{block: block, data: buf[:n]}, nil
}

这里的 block、size、off 和 ReadAt 都是确定的输入；多个调用之间没有共享游标。官方文档也明确了 ReadAt 在读取数量小于缓冲区长度时会返回非空错误，因此并发安全不等于可以忽略返回值。

并发读取时，真正需要隔离的是哪些东西

文件句柄可以共享，但三类状态不要共享：一是每个任务的 buf；二是任务自己的 off 和 block；三是结果写回的位置。最简单的做法是让 worker 返回 chunk，由单独的收集逻辑按 block 排序。

这里别急着加锁。锁住整个 ReadAt 调用会让读取退化为串行；更值得检查的是，是否有 goroutine 在写同一份结果切片，或者主流程已经调用 Close。

短读时为什么不能只判断 err

假设文件还剩 300 字节，但本次缓冲区需要 512 字节，ReadAt 会返回 n == 300，同时返回非空错误。对于文件尾部，这个错误通常是 io.EOF。此时 buf[:n] 才是有效数据，不能继续把 512 字节全部交给解析器。

n, err := f.ReadAt(buf, off)
if n > 0 {
    consume(buf[:n])
}
if err != nil && err != io.EOF {
    return fmt.Errorf("read block %d: %w", block, err)
}

如果业务要求“每块必须完整”，可以把 n != len(buf) 作为失败条件；如果业务允许最后一块不足，则保留 buf[:n]，只把 io.EOF 作为结束信号。两种策略都比无条件忽略错误可靠。

三个容易混淆的边界

能并发 ReadAt，就能并发 WriteAt 吗

不能直接类推。并发读取只讨论多个读取调用；一旦同时有写入，需要额外考虑数据一致性、覆盖范围和文件系统语义。本文的 ReadAt 方案默认文件内容在读取期间不会被业务写入。

读取完成前可以 Close 吗

不可以把 Close 当成“通知任务停止”。应等待所有读取任务返回，再关闭共享的 *os.File；否则仍在运行的调用可能得到关闭错误。

为什么不直接用 ReadFile

ReadFile 适合一次性拿到整个文件。需要限制内存、并发处理独立区间或支持失败重试时，ReadAt 更容易表达读取范围。

延伸问答：怎么快速检查实现是否可靠

多个任务是否共用了同一个 buf

如果是，先拆成每任务独立缓冲区，再检查结果是否按 block 归位。

短读是否保留了 buf[:n]

读取尾块时应保留有效的 n 字节，并明确 io.EOF 是结束还是失败。

Close 是否发生在全部任务结束之后

把关闭动作放在等待逻辑之后，并在测试中覆盖空文件、尾块和提前取消场景。

结论

os.File.ReadAt 的价值在于把读取位置变成调用参数：同一个文件可以被多个 goroutine 按不同 off 并发读取。工程实现的验收点不是“加没加锁”，而是每个任务是否独立管理 buf、是否按 n 处理短读、是否等所有读取结束后再 Close。