Go io.MultiWriter 写入失败时怎样判断部分结果

用 io.MultiWriter 同时写日志、文件和另一个输出端时，最容易误判的是“返回失败，就说明所有目标都没有写入”。实际行为是：它按传入顺序逐个调用 Writer；某个 Writer 返回错误，或者只写入了一部分字节时，当前写入立即停止，后面的 Writer 不再调用。因此，失败并不等于没有副作用，n 也不是所有 Writer 的累计字节数。

判断部分结果要同时看 Writer 的排列顺序、当前返回的 n 和 err。前面的 Writer 可能已经完整收到数据，失败 Writer 可能只收到一部分，后面的 Writer 则可能完全没有被调用。

io.MultiWriter 到底按什么顺序写入

io.MultiWriter(w1, w2, w3) 返回一个新的 io.Writer。每次调用它的 Write(p)，标准库都会把同一份 p 交给列表中的 Writer，并且一次只处理一个。某个 Writer 返回非空错误后，MultiWriter 直接返回，不会跳到下一个目标。

这个顺序会影响业务设计。把文件 Writer 放在日志 Writer 前面，和把日志 Writer 放在前面，失败时留下的部分结果并不相同。需要“尽量写入多个目标”时，不能把 MultiWriter 当成并发广播器；它没有为每个目标建立独立的失败隔离。

短写入为什么也会提前停止

io.Writer 的约定是：如果返回的 n 小于 len(p)，通常必须同时返回非空错误。标准库的 MultiWriter 还会额外保护一次：如果某个 Writer 返回了短写入但错误为 nil，它会把错误改成 io.ErrShortWrite，并停止继续调用。

package main

import (
	"errors"
	"fmt"
	"io"
)

// partialWriter 用来表达一个可能只接收部分字节的目标。
type partialWriter struct {
	name  string
	limit int
}

func (w *partialWriter) Write(p []byte) (int, error) {
	// limit 小于 0 表示完整接收，否则模拟目标只能接收 limit 字节。
	if w.limit >= 0 && len(p) > w.limit {
		return w.limit, errors.New(w.name + " 写入失败")
	}
	return len(p), nil
}

func main() {
	first := &partialWriter{name: "A", limit: -1}
	second := &partialWriter{name: "B", limit: 3}
	third := &partialWriter{name: "C", limit: -1}

	// 目标按 A、B、C 排列；B 失败后，C 不会被调用。
	w := io.MultiWriter(first, second, third)
	n, err := w.Write([]byte("golang"))
	fmt.Printf("n=%d err=%v\n", n, err)
}

上面的代码只用于说明返回值关系，不把示例输出当成线上运行证据。按照接口语义，n 反映这次 MultiWriter 写入在失败点返回的字节数；它不会告诉你 A 已经写入了多少，也不能证明 C 收到了数据。若 Writer 返回 n=3 和错误，A 可能已经完整收到 6 个字节，B 只收到 3 个字节，C 还没有调用。

为什么返回 n 不能代表所有 Writer 的总结果

排障时可以把一次写入拆成三类状态：

• 前置 Writer：已经被调用，可能已经产生完整副作用。
• 当前失败 Writer：根据 n 和 err 判断是部分接收、明确报错，还是标准库补出的 io.ErrShortWrite。
• 后置 Writer：失败发生后通常没有调用，不能按“应该收到”处理。

因此，重试前先问一个问题：前置目标是否幂等？如果是追加文件、发送消息或写入外部系统，简单重试可能制造重复内容。更稳妥的做法是给每次业务写入带上唯一标识，记录各目标的完成状态，或者把目标拆开分别写入，让每个目标拥有独立的重试和补偿策略。

迁移和排障时保留这张清单

把多个目标交给 io.MultiWriter 前，先固定并记录目标顺序；处理返回值时同时判断 n 与 err，不要只看错误字符串；遇到 io.ErrShortWrite 时按“当前目标未完整接收”处理；失败后不要默认后置 Writer 已经写入。若业务要求真正的独立失败隔离，就改成逐个目标调用并保存结果，而不是依赖一个总 Writer 隐藏中间状态。

相关问题

io.MultiWriter 会并发写入多个目标吗？

不会。它按传入顺序逐个调用 Writer。若需要并发，需要自行设计并发模型、错误收集和资源生命周期。

返回 n 等于 len(p) 就能说明所有目标都成功吗？

只能说明这次 MultiWriter 调用返回了完整长度；结合实现语义，它表示列表中的 Writer 都完成了对应写入且没有返回错误。若返回错误，则不能把 n 当成所有目标的累计结果。