Go语言错误处理的核心在于显式处理和合理包装。通过error接口及fmt.Errorf添加上下文,优先使用errors.Is和errors.As进行错误判断与类型提取,避免重复包装。自定义错误需实现Error()和Unwrap()方法以支持错误链。函数应将error作为最后一个返回值,公开API需定义可预期的错误类型。defer中处理关闭错误时应谨慎覆盖原错误。HTTP服务中通过中间件将错误转换为对应状态码并统一响应。记录错误时结合上下文和%+v获取堆栈信息,可借助第三方库实现堆栈跟踪。测试中推荐用errors.Is或testify的ErrorIs断言错误。整体原则为:显式处理、精准判断、上下文丰富、安全包装。

Go语言的错误处理机制简洁而强大,关键在于正确理解和使用
error
Go中的
error
type error interface {
Error() string
}这意味着任何实现
Error()
errors.New
fmt.Errorf
建议:优先使用
fmt.Errorf
立即学习“go语言免费学习笔记(深入)”;
当需要根据错误类型做出不同处理时,应使用
errors.Is
errors.As
os.ErrNotExist
示例:
if errors.Is(err, os.ErrNotExist) {
// 处理文件不存在
}
<p>var pathErr *os.PathError
if errors.As(err, &pathErr) {
log.Println("Path:", pathErr.Path)
}对于复杂业务逻辑,定义结构体错误类型可以携带更多信息。
示例:
type MyError struct {
Code int
Message string
Op string
Err error
}
<p>func (e *MyError) Error() string {
return fmt.Sprintf("%s: %d - %s", e.Op, e.Code, e.Message)
}</p><p>func (e *MyError) Unwrap() error {
return e.Err
}注意:实现
Unwrap()
errors.Is
errors.As
使用
fmt.Errorf
%w
if err != nil {
return fmt.Errorf("failed to read config: %w", err)
}这样既添加了上下文,又可通过
errors.Is
errors.As
避免:不要用
%v
%s
nil
*MyError(nil)
err != nil
在
defer
Close
常见模式:
file, err := os.Open("data.txt")
if err != nil {
return err
}
defer func() {
if closeErr := file.Close(); closeErr != nil {
// 可记录日志,或覆盖原错误(谨慎)
log.Printf("Close error: %v", closeErr)
}
}()若原函数已出错,一般不再覆盖返回错误,除非关闭失败更严重。
Web服务中,错误应转换为合适的HTTP状态码。
推荐做法:
示例:
type HTTPError struct {
Status int
Message string
}
<p>func (e *HTTPError) Error() string {
return e.Message
}中间件中:
if err != nil {
var httpErr *HTTPError
if errors.As(err, &httpErr) {
w.WriteHeader(httpErr.Status)
} else {
w.WriteHeader(500)
}
json.NewEncoder(w).Encode(map[string]string{
"error": err.Error(),
})
}记录错误时,建议包含:
%+v
github.com/pkg/errors
fmt.Errorf
标准库目前不支持堆栈跟踪,如需堆栈,可使用第三方库如
github.com/pkg/errors
golang.org/x/xerrors
使用
errors.Is
errors.As
示例:
if !errors.Is(err, expectedErr) {
t.Errorf("want %v, got %v", expectedErr, err)
}或使用
require.ErrorIs(t, err, expectedErr)
基本上就这些。掌握这些模式,能应对绝大多数Go项目中的错误处理需求。核心是:显式处理、合理包装、精准判断、上下文丰富。
以上就是Golang错误处理终极指南 综合各种场景的最佳实践的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号