Go bytes.Reader 需要重复读取时怎么用 Seek 重置位置

bytes.Reader 读到末尾后，下一次读取拿到 io.EOF 是正常行为。它内部维护着读取位置，不会因为再次调用 Read 就自动回到开头。需要重复消费同一份字节数据时，直接调用 Seek(0, io.SeekStart)，再把 Reader 交给读取函数即可。

官方资料：https://pkg.go.dev/bytes

先理解 bytes.Reader 的读取游标

bytes.NewReader(data) 创建的是一个只读 Reader。它实现了 io.Reader、io.ReaderAt 和 io.Seeker 等接口，所以既能顺序读取，也能定位到指定偏移。第一次创建时位置是 0；每次 Read 成功读取 n 个字节，位置就向后移动 n。

容易混淆的是 Len() 和原始数据长度。Len() 返回“未读部分”的长度，读到末尾后会变成 0，而不是说明底层切片被清空。比如数据有 12 个字节，先读掉 5 个，Len() 返回的就是 7。

用 Seek(0, io.SeekStart) 回到开头

最常见的重复读取场景是：第一次把 Reader 交给 io.ReadAll、JSON 解码器或上传函数，第二次还要把同一份内容交给另一个消费者。此时不需要复制字节切片，只需把游标设为起点。

package main

import (
	"bytes"
	"fmt"
	"io"
)

func main() {
	data := []byte("config=demo&mode=fast")
	r := bytes.NewReader(data)

	first, err := io.ReadAll(r)
	if err != nil {
		// 第一次消费失败时立即返回，避免把不完整数据继续传下去。
		panic(err)
	}
	fmt.Println(string(first))

	pos, err := r.Seek(0, io.SeekStart)
	if err != nil {
		// Seek 可能因为非法位置失败，不能忽略它的返回值。
		panic(err)
	}
	fmt.Println("position:", pos, "remaining:", r.Len())

	second, err := io.ReadAll(r)
	if err != nil {
		// 重置后再次读取仍然要按 io.Reader 约定处理错误。
		panic(err)
	}
	fmt.Println(string(second))
}

关键点是 Seek 的第一个参数是偏移量，第二个参数是参照点。这里用偏移 0 加 io.SeekStart，得到的新位置就是 0。成功后 Len() 又恢复为底层切片长度，后续的 Read 会从第一个字节开始。

按起点、当前位置和末尾选择 Seek 参数

Seek(offset, whence) 支持三种参照点：io.SeekStart 从数据开头算，io.SeekCurrent 从当前位置算，io.SeekEnd 从数据末尾算。重复读取通常固定用第一种，解析文件头、回退少量字节时才会用后两种。

// 从当前位置向后跳 2 个字节，返回新的绝对位置。
pos, err := r.Seek(2, io.SeekCurrent)
if err != nil {
	// 负位置或非法 whence 都会返回错误，保留当前位置并结束本次操作。
	return err
}
fmt.Println("new position:", pos)

// 从末尾向前定位 4 个字节；offset 为负数表示向前回退。
pos, err = r.Seek(-4, io.SeekEnd)
if err != nil {
	// 数据太短时可能得到负位置，调用方应根据错误决定是否放弃。
	return err
}

bytes.Reader 的实现会拒绝负的绝对位置，但不会把位置强行限制在数据长度以内。定位到末尾之后继续 Read 会得到 io.EOF；定位到末尾之外时也应把它当成“当前没有可读字节”来处理。因此生产代码不要只看 Seek 返回了 nil，还要结合 Len() 判断后续是否有内容。

区分 Seek、ReadAt 和 Reset

如果多个消费者要并行查看同一份数据，频繁修改共享 Reader 的位置会让调用关系变得脆弱。只想读取某个固定偏移时，可以使用 ReadAt，它按给定位置读取，不修改顺序游标。

Reset 解决的是另一类问题：Reader 仍然可以复用，但底层数据已经换成另一份切片。它会把位置重新设为 0。若只是把同一份内容再读一遍，不要误用 Reset，此时 Seek 表达的意图更准确。

buf := make([]byte, 4)
n, err := r.ReadAt(buf, 3)
if err != nil && err != io.EOF {
	// ReadAt 可能只读到部分数据，先区分真正失败和尾部 EOF。
	return err
}
fmt.Println(n, string(buf[:n]))

// 只有准备复用 Reader 读取另一份数据时，才调用 Reset。
r.Reset([]byte("new payload"))
fmt.Println(r.Len())

常见问题

bytes.Reader 读完后直接再次 Read 为什么只有 EOF？

因为游标已经在数据末尾。调用 Seek(0, io.SeekStart) 后再读即可；如果只需要一小段固定偏移内容，则考虑 ReadAt。

Seek(0, io.SeekStart) 会复制底层字节吗？

不会。它只改变 Reader 的当前位置，底层字节切片仍由原来的 Reader 引用。

什么时候应该重新创建 bytes.NewReader？

当你希望不同调用方拥有完全独立的游标，或者代码需要避免共享可变状态时，重新调用 bytes.NewReader(data) 更直观；数据量很大时则可以优先评估 ReadAt 或单独管理位置。