Go io.SectionReader 的 Size 与 ReadAt 如何配合：分片下载的边界判断

做分片下载时，最容易混淆的是“文件全局偏移”和“当前分片内部偏移”。io.NewSectionReader 把底层 io.ReaderAt 包成一个固定区间：Size() 告诉你这个区间有多长，ReadAt 接收的是区间内偏移，而不是原文件偏移。先用 Size() 校验块范围，再读取相对偏移，才能把最后一个短分片和越界请求区分开。

分片下载的边界判断应围绕 SectionReader 的长度做：请求偏移必须满足 0 ，读取长度超过剩余空间时，返回的字节数可能小于缓冲区长度并伴随 io.EOF。

先把完整文件切成一个可验证的区间

假设对象存储或本地文件的全局数据由 readerAt 提供，我们要读取从全局偏移 100 开始、长度 260 字节的分片：

section := io.NewSectionReader(readerAt, 100, 260)
fmt.Println(section.Size()) // 260

这里的 100 只在创建时参与定位。创建完成后，section 对外暴露的是一个从 0 到 259 的小区间；Size() 返回 260，而不是底层文件剩余长度。源码中的 limit - base 正是这个含义。

这一步的价值在于把“分片长度”变成一个可重复使用的校验条件。HTTP Range、任务队列或数据库里的块记录都可以先对照这个值判断请求是否合法。

ReadAt 的 off 是分片内偏移，不是文件偏移

读取分片开头 64 字节时，应该传入 off=0。SectionReader 会把它换算成底层 ReaderAt 的 base + off：

buf := make([]byte, 64)
n, err := section.ReadAt(buf, 0) // 实际从 readerAt 的 100 开始读
if err != nil && !errors.Is(err, io.EOF) {
    return err
}
fmt.Println(n)

如果误把全局偏移 100 再传给 ReadAt，SectionReader 会把它当作区间内第 100 字节，实际读到全局偏移 200 附近，结果看起来像“分片内容错位”。分片下载器最好把全局块起点只保存在创建 SectionReader 的地方，后续函数只接收区间内偏移。

当 off 或 off >= section.Size() 时，源码直接返回 io.EOF。当缓冲区跨过区间末尾，SectionReader 会缩短传给底层的切片；如果只读到一部分，n 小于原始缓冲区长度，这也是边界信号。

把分片请求写成先校验、后读取

一个简单的分片读取函数可以把错误边界固定下来。它不把 off+length 超出区间的请求静默截断，而是让调用方知道自己请求了不存在的字节：

func readChunk(section *io.SectionReader, off int64, length int) ([]byte, error) {
    if off = section.Size() || int64(length) > section.Size()-off {
        return nil, fmt.Errorf("chunk out of section: off=%d length=%d size=%d", off, length, section.Size())
    }
    buf := make([]byte, length)
    n, err := section.ReadAt(buf, off)
    if err != nil && !errors.Is(err, io.EOF) {
        return nil, err
    }
    if n != len(buf) {
        return nil, io.ErrUnexpectedEOF
    }
    return buf, nil
}

这里的检查顺序有两个细节：先判断 off 是否落在区间内，再用 section.Size()-off 计算剩余长度，避免直接做可能溢出的加法；读取后仍核对 n，因为 ReaderAt 的实现可能在数据不足时返回短读。

分片大小、偏移和错误的核对表

常见误区：为什么最后一块不能按固定长度重试

文件总长度不能被块大小整除时，最后一个 SectionReader 本来就可能比前面的块短。若调用方仍按固定长度申请缓冲区，ReadAt 会返回实际可读字节数和 EOF；这不是网络重试信号。应由上层根据已知的剩余长度创建最后一个 section，或者把短读视为完成条件。

另一个误区是把 Read 和 ReadAt 混在同一条读取路径里。Read 会推进 SectionReader 自己的当前位置，ReadAt 使用显式的区间内偏移；并发下载时如果每个任务都需要确定位置，优先使用 ReadAt，不要共享一个会变化的当前位置。

常见问题

Size() 返回的是底层文件大小吗？

不是。它返回创建 SectionReader 时指定的区间长度，也就是 n，与底层 ReaderAt 的总长度无关。

ReadAt 的 off 能直接填 HTTP Range 的起点吗？

不能直接填。HTTP Range 的起点通常是全局偏移，而 ReadAt 需要分片内偏移；若 SectionReader 从全局 100 开始，区间开头应传 0。

读到 EOF 就一定是文件损坏吗？

不一定。跨过 SectionReader 的固定边界时，EOF 是正常的范围信号。只有在请求本应完整、且已核对区间长度后仍短读，才需要继续检查底层数据源。

最后的采用建议

把全局偏移和分片内偏移分成两个变量，并让创建 SectionReader 的代码负责全局定位；下载任务只拿到 Size()、相对 off 和期望长度。这样一来，越界、最后短块和底层读错误各有明确落点，重试策略也不会把正常 EOF 当成故障。