Go中条件错误处理通过显式检查error是否为nil,再用fmt.Errorf(推荐%w)包装或errors.New创建自定义错误,并支持errors.Is/As进行类型判断与上下文增强。

在 Go 中,条件错误处理通常通过 if 判断函数返回的错误值,并根据具体错误类型或内容决定是否返回自定义错误。这不是简单的“抛异常”,而是显式检查、封装和传递错误。
判断错误是否为 nil 并返回自定义错误
大多数 Go 标准库和第三方函数按约定返回 (result, error)。最基础的做法是先检查 error 是否为 nil,再按需构造新错误:
- 若原错误非空,可直接返回,也可用
fmt.Errorf包装并添加上下文 - 若需区分错误类型(如网络超时、文件不存在),可用类型断言或
errors.Is/errors.As
示例:
func readFileWithCustomErr(filename string) ([]byte, error) {data, err := os.ReadFile(filename)
if err != nil {
if os.IsNotExist(err) {
return nil, fmt.Errorf("配置文件未找到:%s", filename)
}
return nil, fmt.Errorf("读取文件失败:%w", err)
}
return data, nil
}
使用 errors.New 或 fmt.Errorf 创建自定义错误
Go 原生支持轻量级错误创建:
立即学习“go语言免费学习笔记(深入)”;
-
errors.New("xxx"):适合无参数的静态错误信息 -
fmt.Errorf("xxx: %w", err):带原始错误链(推荐用于包装) -
fmt.Errorf("xxx: %v", err):仅记录错误字符串,丢失原始类型和堆栈
注意:%w 是错误嵌套的关键,能让 errors.Is 和 errors.Unwrap 正常工作。
基于业务逻辑主动触发自定义错误
除了处理外部错误,你也可以在条件不满足时主动返回自定义错误:
- 参数校验失败(如 ID ≤ 0、用户名为空)
- 状态非法(如订单已支付却尝试再次扣款)
- 权限不足(当前用户无权操作某资源)
示例:
func transfer(amount float64, from, to string) error {if amount return errors.New("转账金额必须大于 0")
}
if from == to {
return errors.New("转出与转入账户不能相同")
}
// ... 实际转账逻辑
return nil
}
统一错误类型便于下游判断
当需要被调用方做精细化错误处理(如重试、降级、日志分级),建议定义自己的错误类型:
- 实现
error接口 + 自定义字段(如 Code、TraceID) - 提供辅助函数如
IsValidationError(err)或IsNetworkError(err) - 避免仅靠字符串匹配判断错误(脆弱且不可扩展)
简单自定义类型示例:
type AppError struct {Code int
Message string
}
func (e *AppError) Error() string { return e.Message }
func NewValidationError(msg string) error {
return &AppError{Code: 400, Message: "参数错误:" + msg}
}










