Golang自定义异常处理技巧分享

哈喽！今天心血来潮给大家带来了《Golang自定义异常处理方法详解》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

Go通过实现error接口定义自定义错误类型，如HttpError结构体；使用errors.Is和errors.As判断和提取错误；结合defer、panic与recover在中间件等场景模拟异常捕获；提倡错误为值的理念，优先返回error而非滥用panic，确保错误可追溯、可处理。

在Go语言中，没有传统意义上的“异常”机制，比如Java中的try-catch或Python的raise。Go通过error类型和panic/recover机制来处理错误和运行时异常。但我们可以利用这些特性实现类似“自定义异常”的行为，提升代码的可读性和错误管理能力。

定义自定义错误类型

Go推荐通过实现error接口来自定义错误类型。error接口只有一个方法：Error() string。我们可以通过结构体封装更多信息，如错误码、状态、时间等。

type HttpError struct {
    Code    int
    Message string
    TraceID string
}

func (e *HttpError) Error() string {
    return fmt.Sprintf("HTTP %d: %s (trace: %s)", e.Code, e.Message, e.TraceID)
}

使用时可以这样创建错误：

err := &HttpError{
    Code:    404,
    Message: "资源未找到",
    TraceID: "abc123",
}
return err

使用 errors.Is 和 errors.As 进行错误判断

从Go 1.13开始，标准库提供了errors.Is和errors.As，便于判断错误类型和提取原始错误。

假设你在调用链中包装了自定义错误：

wrappedErr := fmt.Errorf("处理请求失败: %w", &HttpError{Code: 500, Message: "服务器错误"})

可以在上层判断是否为特定类型：

if errors.Is(err, &HttpError{Code: 500}) { // 注意：Is 更适合比较值
    // 处理500错误
}

更推荐使用errors.As来提取具体错误类型：

var httpErr *HttpError
if errors.As(err, &httpErr) {
    fmt.Printf("捕获HTTP错误: %v\n", httpErr.Code)
}

结合 panic 和 recover 实现异常式流程控制（谨慎使用）

虽然Go不鼓励滥用panic，但在某些场景下（如中间件、框架层），可以用defer + recover模拟“异常捕获”。

func RecoverMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if r := recover(); r != nil {
                var errorMsg string
                switch x := r.(type) {
                case string:
                    errorMsg = x
                case error:
                    errorMsg = x.Error()
                default:
                    errorMsg = "未知错误"
                }
                log.Printf("Panic recovered: %v", r)
                http.Error(w, "服务器内部错误", 500)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

你也可以在业务中主动触发“异常”：

func divide(a, b int) int {
    if b == 0 {
        panic(&HttpError{Code: 400, Message: "除数不能为零"})
    }
    return a / b
}

然后在调用处用defer-recover捕获：

func safeDivide(a, b int) (result int, err error) {
    defer func() {
        if r := recover(); r != nil {
            if e, ok := r.(*HttpError); ok {
                err = e
            } else {
                err = fmt.Errorf("未知错误: %v", r)
            }
        }
    }()
    result = divide(a, b)
    return
}

最佳实践建议

Go的哲学是“错误是值”，应优先使用返回error的方式处理问题，而不是依赖panic。

• 不要滥用panic：仅用于不可恢复的错误，如配置缺失、程序逻辑错误。
• 自定义错误应包含上下文：比如错误码、trace ID、时间戳等，便于日志追踪。
• 使用%w包装错误：保留原始错误信息，方便后续分析。
• 公开API应返回error而非panic：确保调用者能安全处理错误。

基本上就这些。Go虽然没有传统异常机制，但通过error设计和适当的recover模式，完全可以实现清晰、可控的“自定义异常”处理逻辑。关键在于合理封装和统一规范。

本篇关于《Golang自定义异常处理技巧分享》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！