io.TeeReader不能直接用于一写多读，因其仅支持单次镜像写入且不缓存数据；正确方案是先缓存到bytes.Buffer再为各目标构建独立TeeReader，或用io.Pipe实现并发“一读多写”。
直接用 io.TeeReader 无法实现真正的一写多读，它只支持“一读一写”，要一写多读必须组合多个 TeeReader + io.MultiReader，否则会丢数据或阻塞。
为什么 io.TeeReader 不能直接用于一写多读
io.TeeReader 的设计目标是“边读边镜像一次”，它把每次 Read 调用的数据原样返回给调用方，同时写入一个指定的 io.Writer。它不缓存、不重试、不复制流——这意味着：
- 你传给它的
io.Writer只能是一个，传io.MultiWriter是无效的：后者在写入时才分发，而TeeReader的写入动作发生在Read内部，MultiWriter无法被触发多次 - 下游
Writer写失败（如磁盘满、网络超时），Read就立即返回错误，上游读取链路被中断 - 它不提供“复制一份供后续多次读取”的能力，更不是
io.ReadCloser的增强替代品
正确构造一写多读的三步法
本质是把“写”从读路径中解耦出来，让每个目标独立消费同一份原始字节流。标准做法是：io.MultiReader 合并多个 io.Reader，每个 Reader 来自独立的 io.TeeReader + bytes.Buffer 回环。
- 第一步：用
bytes.Buffer接收原始流全部内容（注意内存占用）
buf := &bytes.Buffer{}<br>_, err := io.Copy(buf, src) - 第二步：为每个目标 Writer 构建独立
TeeReader，但 Reader 源统一来自bytes.NewReader(buf.Bytes())
tee1 := io.TeeReader(bytes.NewReader(buf.Bytes()), writer1)<br>tee2 := io.TeeReader(bytes.NewReader(buf.Bytes()), writer2)
- 第三步：用
io.MultiReader(tee1, tee2)合并读取路径——注意：这仅适用于你明确需要“串行消费多个副本”的场景；若目标是并发写入不同终点（如日志+审计+监控），应直接启动多个 goroutine 分别处理bytes.NewReader(buf.Bytes())，无需MultiReader
大文件或流式场景下的低损耗替代方案
全量缓存到 bytes.Buffer 在上传文件、HTTP Body 等场景下极易 OOM。此时必须放弃“一写多读”幻想，改用“一读多写”架构：
立即学习“go语言免费学习笔记（深入）”；
- 用
io.Pipe创建管道，写端由原始 Reader 驱动（如io.Copy(pipeWriter, src)），读端接多个 goroutine - 每个 goroutine 拿到
pipeReader后，自行封装io.TeeReader写向各自目标：io.TeeReader(pipeReader, targetWriter) - 关键约束：所有 goroutine 必须共用同一个
*io.PipeReader实例，且不能调用Seek或重复Read——PipeReader是单次顺序流 - 务必用
context.WithCancel控制整个管道生命周期，任一目标 Writer 失败时主动 cancel，避免管道挂起
真正难的不是拼出代码，而是判断该不该做一写多读：90% 的需求其实只需要“读一次，分发写多次”，而非“写一次，供多次读”。别被术语带偏，先想清楚数据流向和失败传播边界。
