如何在Golang中捕获错误信息_使用error类型和自定义错误处理

Go通过显式返回error接口值处理错误，需主动检查；标准errors.New和fmt.Errorf（支持%w嵌套）适用于简单与上下文错误；自定义错误类型可扩展字段和方法；应使用errors.Is/As判断而非字符串匹配；错误链和统一日志增强可维护性。

在 Go 中，错误处理不是靠异常机制，而是通过显式返回 error 类型值来实现的。Go 要求你“看见”错误、主动检查它，而不是隐式抛出和捕获。掌握标准 error 接口、合理使用 errors.New 和 fmt.Errorf，再配合自定义错误类型，就能写出清晰、可调试、可扩展的错误处理逻辑。

理解 error 是一个接口，不是特殊类型

Go 的 error 是一个内建接口：

type error interface {
Error() string
}

任何实现了 Error() string 方法的类型，都可作为 error 使用。标准库中的 errors.New("msg") 返回的是一个内置的私有结构体，它只携带字符串；而 fmt.Errorf("format %v", v) 支持格式化，还支持嵌套（用 %w 动词）。

用 errors.New 创建简单、无上下文的错误，比如 errors.New("file not found")
用 fmt.Errorf 添加动态信息或包裹底层错误，比如 fmt.Errorf("reading config: %w", err)
不要忽略返回的 error，至少写 if err != nil { return err } 或明确记录/处理

用 %w 实现错误链（Wrapping），保留原始错误上下文

从 Go 1.13 开始，%w 动词让错误可以嵌套，形成“错误链”。这让你既能向上层提供有意义的错误消息，又能用 errors.Unwrap、errors.Is、errors.As 向下检查原始错误类型或值。

包装： return fmt.Errorf("failed to connect to DB: %w", sql.Open(...))
判断是否是某类错误：if errors.Is(err, os.ErrNotExist) { ... }
提取底层错误实例：var pathErr *os.PathError; if errors.As(err, &pathErr) { log.Println("path:", pathErr.Path) }
避免用 == 或 strings.Contains(err.Error(), "...") 做错误判断，它们脆弱且不可靠

定义自定义错误类型，支持更多行为和字段

当需要携带状态码、追踪 ID、重试建议等额外信息时，定义结构体并实现 Error() 方法即可：

type ValidationError struct {
  Field string
  Value interface{}
  Code int
}

func (e *ValidationError) Error() string {
  return fmt.Sprintf("validation failed on %s: %v (code: %d)", e.Field, e.Value, e.Code)
}

// 可选：实现 Is 或 As 的支持，便于统一判断
func (e *ValidationError) Is(target error) bool {
  _, ok := target.(*ValidationError)
  return ok
}

导出字段方便外部读取（如日志、API 响应）
若需类型断言或行为扩展（比如 Retryable() 方法），直接加方法即可
注意：如果要参与错误链，推荐用 fmt.Errorf("...: %w", e) 包装，而非自己实现 Unwrap() —— 除非你有特殊需求

统一错误处理模式：中间件、defer 恢复、日志增强

在实际项目中，错误不只出现在函数内部，还需考虑 HTTP handler、CLI 命令、数据库事务等场景：

HTTP handler 中，用 defer + recover 处理 panic（仅限真正意外），但常规错误应由 handler 显式返回并转为 HTTP 状态码
CLI 工具可用 main() 返回 error，被 os.Exit(1) 自动处理；配合 log.SetPrefix("[ERROR] ") 统一日志前缀
关键操作前后用 defer 记录成功/失败，比如 defer func() { if err != nil { log.Printf("operation failed: %v", err) } }()
避免重复打印同一错误：不要在每一层都 log.Println(err)，而是在最外层（如 main 或 handler）集中记录，并保留完整错误链

# go # golang # app # 工具 # ai # 状态码 # 标准库 # sql # 中间件 # String # if # format # Error # printf # 字符串 # 结构体 # bool # int # 接口 # Struct # Interface # var # nil # 数据库 # http # 自定义 # 是一个 # 而非 # 的是 # 是在 # 就能 # 出现在 # 适用于 # 你有 # 可选

返回目录在线咨询

上一篇：阿里云服务器的带宽和流量限制对多个网站的影响是什么？
下一篇：四川网络营销教学大纲,川之音文化传媒网络销售靠谱吗？

您的项目需求