定义自定义错误类型、使用错误包装传递上下文、统一API错误响应格式、建立错误映射转换机制，提升Go项目错误处理的可维护性与健壮性。
在Go语言开发中，良好的错误处理是构建稳定系统的关键。随着项目规模扩大，将错误处理逻辑封装到模块中，不仅能提升代码可读性，还能统一错误响应格式、简化调用方处理流程。以下是几种常见的Golang模块化错误处理方法。
1. 定义自定义错误类型
通过实现error接口，可以创建具有上下文信息的错误类型，便于模块内外识别特定错误。
例如，定义一个用户操作相关的错误：
type UserError struct {
Code int
Message string
}
func (e *UserError) Error() string {
return e.Message
}
// 预定义错误实例
var (
ErrUserNotFound = &UserError{Code: 404, Message: "user not found"}
ErrInvalidEmail = &UserError{Code: 400, Message: "invalid email format"}
)
模块函数返回这些预定义错误，调用方可通过比较直接判断错误类型：
立即学习“go语言免费学习笔记（深入）”；
if err == ErrUserNotFound {
// 处理用户未找到
}
2. 使用错误包装（Wrap）传递上下文
从Go 1.13开始，标准库支持错误包装。使用%w格式化动词可将底层错误包装进新错误，保留调用链信息。
模块内部建议逐层包装错误，添加上下文而不丢失原始原因：
func (s *UserService) GetUser(id string) (*User, error) {
user, err := s.repo.FindByID(id)
if err != nil {
return nil, fmt.Errorf("failed to get user from repo: %w", err)
}
return user, nil
}
外部可通过errors.Unwrap、errors.Is或errors.As分析错误链：
if errors.Is(err, sql.ErrNoRows) {
// 底层是数据库无记录
}
3. 统一错误响应格式（适用于API服务）
在Web模块中，可定义统一的错误响应结构，由中间件自动处理错误输出。
type ErrorResponse struct {
Success bool `json:"success"`
Code int `json:"code"`
Message string `json:"message"`
}
编写错误处理中间件：
func ErrorMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if rec := recover(); rec != nil {
w.WriteHeader(500)
json.NewEncoder(w).Encode(ErrorResponse{
Success: false,
Code: 500,
Message: "internal server error",
})
}
}()
next.ServeHTTP(w, r)
})
}
业务模块中直接返回错误，交由公共逻辑处理：
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
4. 错误映射与转换
模块常需对接不同子系统（如数据库、第三方API），可建立错误映射表，将底层错误转为业务语义错误。
func mapStorageError(err error) error {
switch {
case errors.Is(err, sql.ErrNoRows):
return ErrUserNotFound
case errors.Is(err, sql.ErrConnDone):
return &ServiceError{Msg: "storage unavailable", Retryable: true}
default:
return fmt.Errorf("unexpected storage error: %w", err)
}
}
这样上层模块无需了解底层细节，只需处理业务级错误。
基本上就这些。合理封装错误处理，能让模块接口更清晰，系统更健壮。关键是统一规范、保留必要上下文，并对外暴露有意义的错误信息。
