一、错误处理的演进：从返回值到错误链的设计理念
返回值的常规用法与局限
在 Go (Golang) 的 Web 开发中，函数通常通过返回值来传达结果与错误。返回值对错误的可观测性是诊断问题的关键，但也带来函数签名膨胀和调用端的大量重复错误判断。
示例场景：读取配置、解析请求体、数据库查询等操作都会返回一个error，导致调用方需要大量的错误判断逻辑，使代码耦合度上升。
func LoadConfig(path string) (Config, error) {// 读取文件并解析data, err := os.ReadFile(path)if err != nil {return Config{}, err}// 解析var cfg Configif err := json.Unmarshal(data, &cfg); err != nil {return Config{}, err}return cfg, nil
}设计上的启示是把错误作为第一等对象，但单一的错误值往往无法提供足够的上下文，导致排错成本上升。
错误链概念的引入
Go 1.13 引入了错误包装，使得原始错误可追溯，而不丢失上下文。通过 fmt.Errorf("… %w …", err) 可以实现错误链的能力。
if err != nil {return nil, fmt.Errorf("load config failed: %w", err)
}通过这种方式，errors.Is 与 errors.As 可以在调用栈中逐层定位目标错误类型，提升诊断效率。
在 Web 开发场景中，错误链的作用更加明显：可以将业务错误与系统错误区分开来，并为日志记录提供可追溯的上下文。
二、在函数设计中优雅地使用错误返回与包装
错误类型的选择：错误值 vs 自定义错误类型
Go 的标准库鼓励使用sentinel error来表达常见场景，例如 ErrNotFound，结合 errors.Is，在上层逻辑中可以准确捕获具体错误分支。
var ErrNotFound = errors.New("not found")func GetUser(id int) (User, error) {user, ok := repo.find(id)if !ok {return User{}, ErrNotFound}return user, nil
}如果需要传递上下文信息，可以使用自定义错误类型，或通过包装保留更多上下文，方便在 API 层映射到 HTTP 状态码。
如何构建可链式错误：wrap 与 unwrap
使用 %w 进行错误包装，errors.Unwrap 可以逐层解包，errors.Is 与 errors.As 支持模式匹配。
type MyError struct {Code intMsg stringErr error
}func (e *MyError) Error() string { return e.Msg }func (e *MyError) Unwrap() error { return e.Err }func ReadUser(id int) (User, error) {u, err := db.QueryUser(id)if err != nil {return User{}, &MyError{Code: 5001, Msg: "read user failed", Err: err}}return u, nil
}通过这样的设计，错误链的长度和信息密度可以控制，而不会让调用方对底层细节混乱。
三、Web 开发场景中的错误处理实践
HTTP 层的错误传递与统一响应
在 Golang Web 框架中，统一的错误处理机制可以将业务错误与系统错误区分开来，并统一生成 HTTP 响应。将错误传到中间件层，可以避免在每个处理函数中重复处理，提升可维护性与一致性。
type HTTPError struct {Code intMsg stringErr error
}func (e *HTTPError) Error() string { return e.Msg }func WrapHTTPError(code int, msg string, err error) error {return &HTTPError{Code: code, Msg: msg, Err: err}
}// Handler example
func GetProfile(w http.ResponseWriter, r *http.Request) {user, err := svc.GetUserFromRequest(r)if err != nil {// 通过中间件统一处理错误http.Error(w, err.Error(), http.StatusInternalServerError)return}// render userjson.NewEncoder(w).Encode(user)
}中间件 可以读取错误类型，决定返回的HTTP 状态码与错误信息的层级，确保对客户端暴露的只是部分经过提炼的信息。
日志、追踪与用户友好错误信息
在日志中记录完整的错误链信息对于调试至关重要，同时需要向用户返回的信息保持简洁、友好且不暴露实现细节。通过错误包装与错误等级可以实现这一点。
log.WithError(err).Error("profile fetch failed")
// 只暴露普通消息给客户端
http.Error(w, http.StatusText(http.StatusInternalServerError), http.StatusInternalServerError)在 Go 的 Golang Web 开发中，统一的错误策略能显著提升代码的可维护性并减少重复的样板代码。
在实际接口中实现错误链的统一接口
通过设计一个统一的错误结构，可以在前端接口层实现一致的错误码映射，例如字段统一命名与枚举化的业务错误码，帮助前端开发快速定位问题。
type APIError struct {Code stringMessage stringErr error
}func (e *APIError) Error() string { return e.Message }func (e *APIError) Unwrap() error { return e.Err }