当前位置：首页 > 文章列表 > Golang > Go问答 > Go 错误处理 fmt.Errorf 多 %w 怎样处理

Go 错误处理 fmt.Errorf 多 %w 怎样处理

来源：17golang原创 2026-10-31 21:02:24 0浏览收藏

多个 %w 不是把错误简单拼成一条文本，而是让返回值同时保留多个可检索的错误分支。当前 Go 的 fmt.Errorf 在格式串中出现多个 %w 时，会按它们出现的顺序保存这些错误，并提供 Unwrap() []error 关系。实际处理时，优先用 errors.Is 判断哨兵错误，用 errors.As 提取具体错误类型，不要把错误字符串当成协议。

官方地址：https://pkg.go.dev/fmt

下面用一个“读取和写入都可能失败”的自动化任务说明触发场景、错误关系、判断门禁以及失败后的通知策略。

多个 %w 到底返回了什么

可以把两个独立阶段的错误放入同一个返回值，但调用方仍然能分别识别它们。格式串里的第一个 %w 对应第一条分支，第二个 %w 对应第二条分支；错误文本只是给人看的上下文，多错误关系才是给程序判断的结构。

package main

import (
	"errors"
	"fmt"
)

var (
	ErrRead  = errors.New("读取阶段失败")
	ErrWrite = errors.New("写入阶段失败")
)

func mergeTaskErrors(readErr, writeErr error) error {
	// 没有错误时保持 nil，避免把成功任务包装成失败。
	if readErr == nil && writeErr == nil {
		return nil
	}
	// 两个阶段都失败时保留两个可供 errors.Is 检索的分支。
	if readErr != nil && writeErr != nil {
		return fmt.Errorf("任务失败：读取=%w；写入=%w", readErr, writeErr)
	}
	// 只有一个分支时使用单 %w，兼容只期待单层包装的调用方。
	if readErr != nil {
		return fmt.Errorf("任务失败：读取=%w", readErr)
	}
	return fmt.Errorf("任务失败：写入=%w", writeErr)
}

func main() {
	err := mergeTaskErrors(ErrRead, ErrWrite)
	// 文本用于日志，程序分支应使用 errors.Is 或 errors.As。
	fmt.Println(err)
	fmt.Println(errors.Is(err, ErrRead))
	fmt.Println(errors.Is(err, ErrWrite))
}

fmt.Errorf 多个百分号 w 与错误参数、多错误容器和 errors.Is errors.As 的静态关系说明图 — 图1：结构说明图，展示多个 %w 如何组成可供 errors.Is 与 errors.As 检索的多错误关系。

这里的两个错误互相独立，所以适合用多 %w 同时报告。若第二个错误依赖第一个错误的上下文，还是应该按单条错误链逐层包装，避免把有先后关系的因果链误写成并列分支。

errors.Is 和 errors.As 应该怎么选

错误处理的门禁可以这样分：已知的、稳定的错误类别用 errors.Is；需要读取字段的自定义错误用 errors.As。这两个函数都会沿着错误关系查找，因此不需要先手工调用 errors.Unwrap。

type FieldError struct {
	Field string
	Err   error
}

func (e *FieldError) Error() string {
	// 错误文本服务于日志，Field 字段服务于机器判断。
	return fmt.Sprintf("字段 %s 无效：%v", e.Field, e.Err)
}

func (e *FieldError) Unwrap() error {
	// 保留字段错误内部的根因，允许 errors.Is 继续匹配。
	return e.Err
}

func classify(err error) string {
	// Is 只回答“是否包含这个稳定错误”，适合决定重试或拒绝。
	if errors.Is(err, ErrRead) {
		return "进入读取重试队列"
	}
	// As 负责提取具体类型，适合把字段名写入告警或响应。
	var fieldErr *FieldError
	if errors.As(err, &fieldErr) {
		return "拒绝字段：" + fieldErr.Field
	}
	return "记录未分类失败"
}