Go io.MultiWriter 写多份输出时怎么处理部分失败

把一份日志同时写入文件、审计缓冲区和网络输出时，io.MultiWriter 很方便，但它不是事务。它会按传入顺序逐个调用 Writer；某个 Writer 返回错误，当前写入立即停止，后面的 Writer 不会继续收到这次数据。即使前面的目标已经成功，MultiWriter 也不会回滚。因此，处理“部分失败”的关键不是重试整个组合，而是记录每个目标的边界，再决定补偿方式。

先判断：io.MultiWriter 不是事务写入

io.MultiWriter(w1, w2, w3) 返回的仍然只是一个 io.Writer。调用它的代码只会拿到一次 n, err，而不会拿到每个目标的独立回执。官方实现先写 w1，再写 w2，最后写 w3；其中一个目标报错后，循环直接结束。

用 n 和 err 同时识别显式错误与短写

最小用法仍然是检查 err，但在多目标场景中，n 也很重要。Go 的 Writer 约定要求短写必须伴随非空错误；如果某个实现违反约定，io.MultiWriter 会把它转换为 io.ErrShortWrite。下面的示例用一个会在指定位置短写的 Writer，展示如何把首个失败包装成带目标名称的错误。

package main

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

// limitedWriter 模拟一个只能接收前 limit 个字节的目标。
type limitedWriter struct {
    name  string
    limit int
    buf   strings.Builder
}

func (w *limitedWriter) Write(p []byte) (int, error) {
    if len(p) > w.limit {
        // 故意返回短写且不报错，测试 MultiWriter 的保护行为。
        n, _ := w.buf.Write(p[:w.limit])
        return n, nil
    }
    return w.buf.Write(p)
}

func main() {
    logFile := &strings.Builder{}
    audit := &limitedWriter{name: "audit", limit: 5}
    combined := io.MultiWriter(logFile, audit)

    _, err := combined.Write([]byte("request-42"))
    if err != nil {
        // 记录组合失败；logFile 可能已经写入，不能假设它被回滚。
        fmt.Printf("multi-write failed: %v\n", err)
        if errors.Is(err, io.ErrShortWrite) {
            fmt.Println("需要检查 audit 的补偿记录")
        }
    }
}

这个例子里，日志目标排在前面，所以它可能已经保存完整内容；审计目标只接收了前几个字节，随后被组合 Writer 转成 io.ErrShortWrite。如果把审计目标放在日志目标之前，失败则会更早发生，日志目标甚至不会被调用。目标顺序因此是可靠性策略的一部分，而不是纯粹的排列习惯。

为什么部分失败不可回滚

文件、网络连接和缓冲区没有共同的事务协议。io.MultiWriter 只负责复用同一个字节切片并依次调用目标，它不知道目标已经写入了多少，也没有统一的撤销接口。遇到错误时，返回的 n 只能帮助调用方判断当前写入边界，不能证明所有目标都没有副作用。

因此不要用“返回错误就全部重写”作为默认修复。重写可能让已经成功的文件重复一条日志，也可能让网络端收到重复请求。更稳妥的做法是给每个目标分配可追踪的事件编号，并在业务层保存目标状态，例如 log=done、audit=pending、network=not-reached。

按目标重要性选择失败策略

如果所有目标都必须成功，MultiWriter 只适合做传播工具，外层还需要补偿表、幂等键和重试队列。若只是“尽力记录”的调试日志，可以把日志目标放在后面，并在失败时保留主流程返回值。对于审计和主数据，建议拆开写入并分别确认，这样能明确知道哪个目标失败。

• 普通日志：记录错误并降级到本地备用缓冲区，避免日志故障拖垮业务请求。
• 审计事件：携带事件 ID、目标名和已写字节数，使用幂等重试，避免重复审计。
• 网络副本：将“未到达”与“到达但响应失败”分开，重试前确认接收端是否支持幂等。

常见问题

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

不会。它按传入顺序逐个调用 Writer；如果需要并行，必须自己设计并发、错误聚合和背压策略。

某个 Writer 短写但返回 nil，为什么得到 io.ErrShortWrite？

这是 MultiWriter 对 Writer 约定的保护：只要写入字节数小于输入长度且没有明确错误，就返回 io.ErrShortWrite，避免调用方误以为数据完整复制。

出错后能否从失败目标继续写剩余字节？

不能直接假设可以。调用方要先知道失败目标到底写入了多少、是否允许断点续写，以及重复写入是否幂等；否则应把这次事件标为待补偿，由目标专用协议处理。

一句话记忆：io.MultiWriter 解决的是“一份输入如何依次交给多个 Writer”，不解决“多个目标如何原子成功”。部分失败要靠目标状态、幂等设计和补偿机制收尾。