使用error wrapping可保留原始错误上下文并添加信息,从Go 1.13起通过fmt.Errorf配合%w实现包装,每个调用仅支持一个%w且只能包装error接口值;errors.Is用于判断错误链中是否包含目标错误,errors.As则检查是否存在特定类型错误并赋值;可通过errors.Unwrap循环遍历错误链逐层输出信息,有助于调试但应避免过度包装导致冗余。

在Golang中使用error wrapping可以保留原始错误的上下文,同时添加额外的信息,帮助调试和排查问题。从Go 1.13开始,标准库引入了对error wrapping的支持,主要通过fmt.Errorf配合%w动词来实现。
使用 fmt.Errorf 和 %w 进行 error wrapping
当你需要在原有错误基础上添加上下文时,可以使用fmt.Errorf并配合%w:
-
%w只能包装实现了error接口的值,否则会panic - 每个
fmt.Errorf调用只能使用一个%w
package main import ( "fmt" "os" ) func readFile(filename string) error { _, err := os.Open(filename) if err != nil { return fmt.Errorf("failed to open file %s: %w", filename, err) } return nil } func processFile() error { err := readFile("nonexistent.txt") if err != nil { return fmt.Errorf("processing failed: %w", err) } return nil }
使用 errors.Is 和 errors.As 判断 wrapped error
标准库提供了errors.Is和errors.As来处理包装后的错误:
- errors.Is(a, b):判断错误链中是否存在与目标相等的错误
- errors.As(err, &target):判断错误链中是否有指定类型的错误,并赋值给target
package main import ( "errors" "fmt" "os" ) func main() { err := processFile() if err != nil { if errors.Is(err, os.ErrNotExist) { fmt.Println("file does not exist") } var pathError *os.PathError if errors.As(err, &pathError) { fmt.Printf("path error occurred on path: %s\n", pathError.Path) } } }
查看完整的错误链
你可以手动遍历错误链,打印每一层的错误信息:
免费 盛世企业网站管理系统(SnSee)系统完全免费使用,无任何功能模块使用限制,在使用过程中如遇到相关问题可以去官方论坛参与讨论。开源 系统Web代码完全开源,在您使用过程中可以根据自已实际情况加以调整或修改,完全可以满足您的需求。强大且灵活 独创的多语言功能,可以直接在后台自由设定语言版本,其语言版本不限数量,可根据自已需要进行任意设置;系统各模块可在后台自由设置及开启;强大且适用的后台管理支
立即学习“go语言免费学习笔记(深入)”;
func printErrorChain(err error) { for i := 0; err != nil; i++ { fmt.Printf("level %d: %v\n", i, err) err = errors.Unwrap(err) } }
这会逐层输出被包装的错误,有助于调试复杂调用栈中的问题。
基本上就这些。正确使用error wrapping能让你的程序错误处理更清晰,既保留细节又便于定位根源。注意不要过度包装,避免冗余信息干扰判断。









