如何用Golang实现自定义异常处理_Golang 自定义异常处理实践-Golang-PHP中文网

如何用Golang实现自定义异常处理_Golang 自定义异常处理实践

P粉602998670

发布： 2025-11-24 21:23:02

原创

856人浏览过

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

如何用golang实现自定义异常处理_golang 自定义异常处理实践

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

定义自定义错误类型

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

示例：定义一个HTTP相关的自定义错误

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，便于判断错误类型和提取原始错误。

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

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

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模拟“异常捕获”。

示例：Web中间件中捕获未处理的panic

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
}

登录后复制