Go io.SectionReader 读取范围之外的字节为什么拿不到

io.NewSectionReader 不是给底层文件加一个可移动的游标，而是创建了一个固定长度的逻辑窗口。假设调用 io.NewSectionReader(r, 100, 20)，读者看到的是从逻辑偏移 0 到 19 的 20 个字节，它们对应底层对象的 100 到 119；读取逻辑偏移 20 时，底层即使还有数据，也不会被这个 SectionReader 访问。

先把 SectionReader 的窗口算清楚

NewSectionReader(r, off, n) 的第三个参数决定了窗口长度，实际可读区间是从底层 off 开始、最多持续 n 个字节。Size() 返回的也是这个逻辑长度，而不是底层文件总长度。

因此排查时先写一行边界表：

为什么 ReadAt 越界时拿不到底层字节

SectionReader.ReadAt 接收的是相对窗口的偏移。它先检查偏移是否小于 0 或不小于 Size()，通过后才把偏移加上窗口起点交给底层 ReaderAt。这意味着底层文件的绝对偏移不能直接塞给它。

package main

import (
    "fmt"
    "io"
    "strings"
)

func main() {
    // strings.Reader 实现了 ReaderAt；窗口映射到底层字符串的 3 到 6 字节。
    section := io.NewSectionReader(strings.NewReader("0123456789"), 3, 4)
    buf := make([]byte, 3)

    // 逻辑偏移 2 对应底层偏移 5，仍在窗口 [0, 4) 内。
    n, err := section.ReadAt(buf, 2)
    fmt.Printf("n=%d data=%q err=%v\n", n, buf[:n], err)

    // 逻辑偏移 4 已等于 Size()，窗口外的数据不会透传。
    n, err = section.ReadAt(buf, 4)
    fmt.Printf("n=%d data=%q err=%v\n", n, buf[:n], err)
}

第一处读取对应底层的 "567"，第二处读取得到 n=0 和 io.EOF。这里的 EOF 表示逻辑段结束，不代表底层字符串已经结束。

Read、ReadAt 和 Seek 的边界表现怎么区分

Read 使用内部当前位置；当缓冲区比窗口剩余部分更大时，内部实现会先把缓冲区截短，所以一次调用最多消耗到逻辑窗口末尾。读完最后一段后，下一次 Read 才会稳定返回 0, io.EOF。

ReadAt 不依赖这个内部游标，适合并发读取固定位置。请求从窗口内部开始、但长度超过剩余空间时，可能返回已经读到的字节数并同时返回 EOF；请求起点等于或超过 Size() 时则没有字节可返回。不要只判断 err == nil，应先处理 n 再处理错误。

Seek 返回的也是相对窗口起点的逻辑偏移。它可以把当前位置移到窗口末尾，移到更大的正偏移后，后续读取仍然只会得到 EOF；向窗口起点之前移动则返回偏移错误。这个行为容易让人误以为已经定位到底层文件的绝对位置。

跨范围读取时该怎么修复

如果业务只需要读取一个固定片段，保留当前窗口，并把请求长度限制在 Size() 内。若协议头、索引或校验数据确实跨过当前片段，常见处理有两种：

• 重新创建一个覆盖更大范围的 SectionReader，继续使用相对偏移，适合仍想保留分段隔离的场景。
• 直接调用原始 ReaderAt，传入底层绝对偏移，适合读取器本身就是全局索引或随机访问抽象的场景。

调试时可记录 Size()、请求的逻辑偏移、请求长度和 n。在支持的 Go 版本中，Outer() 还可以返回创建窗口时的底层对象、起点和长度，方便确认是否把逻辑偏移误当成绝对偏移。修复前不要简单把 EOF 忽略掉，否则可能把截断的协议包当成完整数据。

常见问题

ReadAt 的 off 应该传文件绝对位置吗？

不应该。它是相对当前 SectionReader 起点的逻辑偏移；需要绝对位置时调用底层 ReaderAt，或重新创建合适的窗口。

ReadAt 返回 n 大于 0 还需要处理 EOF 吗？

需要。窗口末尾可能只读到部分请求，调用方应先消费 p[:n]，再根据协议决定是否把 EOF 当作正常段结束。

把 n 参数设得很大就能读取整个文件吗？

只有在底层对象确实有这些字节且没有溢出风险时才可能达到这个效果。更稳妥的做法是明确文件大小，再按业务片段创建窗口。