Go io.MultiWriter 写入失败后的短写处理与目标顺序设计

Go 的 io.MultiWriter 不是事务复制器，而是按传入顺序逐个调用 Writer 的串行分发器。某个目标返回错误，或返回的字节数小于输入长度时，本次写入立即停止；前面的目标可能已经收到完整数据，后面的目标则不会再被调用。因此，处理短写的关键是检查 n 和 err，而不是只判断一个布尔成功值。

先看清 MultiWriter 的逐目标契约

官方 io.MultiWriter 文档把它比作 Unix tee：同一份字节写入多个目标，但每次只处理一个目标。它会把输入切片交给第一个 Writer，确认完整写入后再交给下一个。这个过程没有事务边界，也不会在后一个目标失败时撤销前一个目标已经写出的内容。

短写时 n 和 err 应该怎样判断

实现 io.Writer 的目标如果返回 n 且没有错误，MultiWriter 会把结果整理为 io.ErrShortWrite 并停止。若目标直接返回底层错误，调用方收到的就是该错误。返回的 n 是这次组合写入在失败点报告的数量，不等于每个目标的完成数量。

package main

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

func writeOnce(w io.Writer, data []byte) error {
    n, err := w.Write(data)
    // n 小于输入长度时，说明本次写入没有覆盖完整数据。
    if err != nil {
        return fmt.Errorf("writer failed after %d bytes: %w", n, err)
    }
    if n != len(data) {
        // Writer 没有给出错误时，用标准短写错误补齐语义。
        return fmt.Errorf("writer short write: %w", io.ErrShortWrite)
    }
    return nil
}

func classify(err error) string {
    // errors.Is 允许保留 ErrShortWrite 的可判断性。
    if errors.Is(err, io.ErrShortWrite) {
        return "目标未完整接收数据"
    }
    return "目标返回了底层错误"
}

func main() {
    _ = classify(writeOnce(io.Discard, []byte("record")))
}

这里的 writeOnce 用于说明检查顺序：先处理底层错误，再处理无错误短写。真实业务还要结合 Writer 的文档判断是否允许重试；MultiWriter 本身不会替你重试。

目标顺序要服务于失败后的业务语义

如果必须使用 MultiWriter，先写“失败后不希望继续产生副作用”的关键目标。例如把主归档 Writer 放在审计副本之前：主目标失败时，副本不会继续接收这条记录。相反，如果把一个容易失败的网络 Writer 放在最前面，网络抖动就可能阻止本地日志目标收到数据。

因此可以先写一张小表再决定顺序：

需要尽力写入时不要假装是一次复制

如果业务要求“某个 Writer 失败，其他目标仍继续”，就不该直接依赖 MultiWriter 的停止语义。可以用顺序循环分别写入，并保存每个目标的错误；这仍然不是事务，也不会自动解决重复发送，但至少能看清哪些目标成功、哪些目标失败。

type writeFailure struct {
    Index int
    Err   error
}

func writeBestEffort(writers []io.Writer, data []byte) []writeFailure {
    failures := make([]writeFailure, 0)
    for i, w := range writers {
        n, err := w.Write(data)
        // 每个目标独立记录结果，后续目标不因前一个失败而跳过。
        if err == nil && n != len(data) {
            err = io.ErrShortWrite
        }
        if err != nil {
            failures = append(failures, writeFailure{Index: i, Err: err})
        }
    }
    return failures
}

这个方案适合诊断日志、可重建副本等“允许部分成功”的场景。若目标之间必须保持一致，则应把写入前的幂等键、补偿记录或上层事务设计清楚，不能用改变 Writer 顺序来伪造一致性。

相关问题

MultiWriter 返回 n 等于所有目标都写入的字节数吗？

不是。它表示组合写入在当前目标处报告的字节数；遇到失败时，前面目标的独立结果不会从接口中返回。

短写后把剩余切片再写一次安全吗？

不能直接假设安全。要先确认目标是否已经消费了前面的字节，以及重复写入是否会产生重复记录；MultiWriter 不保存每个目标的偏移。

目标失败后会自动回滚前面的 Writer 吗？

不会。Writer 接口没有通用回滚约定，已经写出的数据只能由业务层通过补偿或重建处理。