自定义错误类型通过实现 error 接口、使用 errors.As/Is 判断、哨兵错误、错误包装和带状态码错误，提升 Go 项目错误处理的清晰度与健壮性。
在 Go 语言中，错误处理是通过返回 error 类型值来实现的。虽然 errors.New 和 fmt.Errorf 能满足基本需求，但在复杂项目中，我们常需要携带更多信息或区分错误类型。这时，自定义错误类型就显得尤为重要。以下是 Golang 中实现和使用自定义错误类型的常用方法汇总。
1. 实现 error 接口来自定义错误类型
Go 的 error 是一个接口：
type error interface { Error() string }
只要结构体实现了 Error() 方法，就可以作为错误类型使用。
示例：定义一个网络请求超时错误：
立即学习“go语言免费学习笔记（深入）”；
type TimeoutError struct {
URL string
Reason string
}
func (e *TimeoutError) Error() string {
return fmt.Sprintf(“timeout accessing %s: %s”, e.URL, e.Reason)
}
使用方式：
return &TimeoutError{URL: “https://example.com”, Reason: “connection timeout”}
2. 使用 errors.Is 和 errors.As 进行错误判断
从 Go 1.13 开始，errors 包提供了 Is 和 As 函数，用于更精确地判断错误类型。
例如，判断是否为超时错误：
if err := fetch(); err != nil {
if te, ok := err.(*TimeoutError); ok {
log.Printf(“Timeout on URL: %s”, te.URL)
}
}
更推荐使用 errors.As，它能处理包装过的错误：
var te *TimeoutError
if errors.As(err, &te) {
log.Printf(“Timeout on URL: %s”, te.URL)
}
3. 使用哨兵错误（Sentinel Errors）
对于不需要附加信息的固定错误，可定义全局错误变量，称为“哨兵错误”。
var ErrNotFound = errors.New(“resource not found”)
func FindItem(id int) (*Item, error) {
if item, exists := db[id]; !exists {
return nil, ErrNotFound
}
return &item, nil
}
调用方可用 errors.Is 判断：
if errors.Is(err, ErrNotFound) {
// 处理未找到的情况
}
4. 错误包装与信息增强（Go 1.13+）
使用 %w 格式化动词可以包装原始错误，保留调用链信息。
if err != nil {
return fmt.Errorf(“failed to process user %d: %w”, userID, err)
}
之后仍可用 errors.Is 或 errors.As 解包判断原始错误类型。
5. 带状态码的自定义错误
在 Web 服务中，常需返回 HTTP 状态码。可扩展错误类型包含状态码信息：
type HTTPError struct {
Code int
Msg string
}
func (e *HTTPError) Error() string { return e.Msg }
使用示例：
return &HTTPError{Code: 403, Msg: “forbidden access”}
在中间件中可通过类型断言提取状态码：
if httpErr, ok := err.(*HTTPError); ok {
w.WriteHeader(httpErr.Code)
}
基本上就这些。合理设计自定义错误类型，能让错误处理更清晰、健壮，尤其在大型项目中非常关键。关键是实现 Error() 方法，并结合 errors.As 和 errors.Is 做类型判断，必要时使用错误包装传递上下文。不复杂但容易忽略细节。
以上就是Golang如何实现自定义错误类型并返回_Golang自定义错误类型使用方法汇总的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1420213.html
微信扫一扫 
支付宝扫一扫 
