Golang内置error接口与自定义错误实践-Golang-PHP中文网

Golang内置error接口与自定义错误实践

P粉602998670

发布： 2025-09-10 09:59:01

原创

831人浏览过

Go语言通过error接口实现显式错误处理，任何实现Error() string的类型均可作为错误；标准库提供errors.New和fmt.Errorf创建简单错误，自定义错误可携带错误码、时间等上下文信息；Go 1.13起支持用%w包装错误，结合errors.Is和errors.As实现链式判断与类型断言；建议根据场景选择简单错误、自定义类型或错误包装，保持错误处理清晰可控。

golang内置error接口与自定义错误实践

Go语言中的错误处理是通过返回值显式传递错误来实现的，核心机制依赖于内置的 error 接口。这个接口非常简单，只定义了一个方法：

type error interface { Error() string }

任何实现了 Error() 方法的类型都可以作为错误使用。标准库中常见的 errors.New 和 fmt.Errorf 都返回一个实现了该接口的预定义类型。

基本用法：使用内置错误创建

对于简单场景，可以直接使用标准库提供的函数创建错误：

import "errors" func divide(a, b float64) (float64, error) { if b == 0 { return 0, errors.New("cannot divide by zero") } return a / b, nil }

或者使用 fmt.Errorf 添加格式化信息：

立即学习“go语言免费学习笔记（深入）”；

if b == 0 { return 0, fmt.Errorf("division failed: divisor %.2f is invalid", b) }

自定义错误类型：携带更多上下文

当需要传递错误的具体类型或附加信息（如错误码、时间戳、重试建议等）时，应定义自己的错误类型。

type MyError struct { Code int Message string Time time.Time } func (e *MyError) Error() string { return fmt.Sprintf("[%d] %s at %v", e.Code, e.Message, e.Time) }

使用示例：

Text-To-Pokemon口袋妖怪

输入文本生成自己的Pokemon，还有各种选项来定制自己的口袋妖怪

查看详情

func riskyOperation() error { return &MyError{ Code: 4001, Message: "database connection timeout", Time: time.Now(), } }

调用方可以判断错误类型并做针对性处理：

if err := riskyOperation(); err != nil { if myErr, ok := err.(*MyError); ok { log.Printf("Custom error occurred: %v, code: %d", myErr.Message, myErr.Code) // 根据 Code 决定是否重试 } else { log.Printf("Unknown error: %v", err) } }

封装错误（Error Wrapping）与链式判断

从 Go 1.13 开始，支持通过 %w 动词包装错误，保留原始错误信息：

if err := readFile(); err != nil { return fmt.Errorf("failed to process config: %w", err) }

之后可以使用 errors.Is 和 errors.As 进行判断：

if errors.Is(err, os.ErrNotExist) { log.Println("File does not exist") } var myErr *MyError if errors.As(err, &myErr) { log.Printf("Custom error with code: %d", myErr.Code) }

这种方式让错误既保持语义清晰，又能逐层传递上下文，同时支持精确匹配。