Go io.SectionReader 片段长度超过文件时怎么判断

给 io.NewSectionReader 传入的片段长度超过底层文件剩余长度时，它不会替你把 Size() 改成实际可读长度。判断是否“超出文件”，要同时看起始偏移、请求长度、底层总长度，以及读取时返回的字节数和 io.EOF。

先看清 SectionReader 的三个长度

NewSectionReader(r, off, n) 表示从 off 开始，最多暴露 n 个字节。这里的“最多”很关键：它只是给读取器划出的逻辑范围，并不承诺底层 ReaderAt 真的有这么多数据。官方文档也明确说明，读取器会在这段范围结束后返回 EOF。

例如底层文件长度是 100，创建 NewSectionReader(file, 80, 40)，逻辑片段的请求范围是 [80,120)，但实际数据只有 20 个字节。此时 section.Size() 仍然是 40；它回答的是“调用方请求了多长的片段”，不是“底层现在还能读多少”。

用底层长度先判断请求是否越界

如果底层对象能提供总长度，最稳妥的做法是先计算剩余长度。对文件可以使用 Stat().Size()；对内存数据则直接使用切片长度。只要 off 不在合法范围内，或者 n 大于 total-off，就知道这是一个“可能提前 EOF”的片段，而不是等待读取器把它变成错误。

package main

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

func inspectSection(r io.ReaderAt, total, off, want int64) *io.SectionReader {
    // 先检查偏移，避免 total-off 在非法输入下变成误导性的结果。
    if off  total || want  total-off {
        fmt.Printf("可能短片段：请求=%d，剩余=%d\n", want, total-off)
    }
    return io.NewSectionReader(r, off, want)
}

func main() {
    data := strings.NewReader("0123456789")
    section := inspectSection(data, int64(data.Len()), 7, 6)
    if section == nil {
        return
    }
    fmt.Println("逻辑长度:", section.Size())
}

这个例子中底层长度为 10，偏移为 7，剩余只有 3 字节，但请求长度是 6。Size() 打印 6 并不矛盾；它和“可能短片段”的预判分别回答了两个问题。

Read 时不要丢掉已经拿到的数据

真正读取时，不能只写成“只要 err != nil 就丢弃缓冲区”。Read 允许在返回错误的同时给出 n > 0 的有效数据。若业务要求完整拿到 want 字节，就累计读取并在结束后比较；若业务只接受“从偏移开始的可用尾部”，则可以把已读部分作为短片段使用。

func readExpected(s *io.SectionReader, want int64) ([]byte, error) {
    // 用固定目标长度承载结果，避免把缓冲区容量误当作实际数据长度。
    buf := make([]byte, want)
    var got int64
    for got 

四个边界容易被误判

第一，off == total 是合法的空尾部，读取时通常直接得到 EOF；off > total 则应在创建前拒绝。第二，want == 0 表示空片段，不要把它当成读取失败。第三，单次 Read 返回的字节数可能小于缓冲区长度，不能据此断言文件已经结束。第四，SectionReader 只是包装了底层 ReaderAt，并发安全性仍要回到底层对象的约定，不能因为它有独立偏移就默认所有共享访问都安全。

常见问题

为什么 Size() 比文件剩余长度大？

因为 Size() 返回创建时传入的逻辑长度 n。实际边界要结合底层总长度和读取结果判断。

Read 返回 n>0 和 io.EOF 算失败吗？

先处理这 n 个字节。若业务需要完整片段，再把未达到目标长度的情况转换为 io.ErrUnexpectedEOF 或业务错误。

应该把 n 截断到文件剩余长度吗？

取决于语义。允许读取尾部时可以提前截断；需要发现上游长度配置错误时，保留原始请求长度并在读取后显式报告短片段更清楚。

记住一个简单原则：Size() 管的是“我想读多少”，累计读取量管的是“我实际拿到多少”，而 io.EOF 负责告诉你这段数据已经提前结束。