Go中结构体方法返回错误的标准做法是将error作为最后一个返回值，调用处显式检查并透传；通过统一签名、if err!=nil立即返回、%w包裹错误及封装校验逻辑实现“统一捕获并返回error”。
在 Go 中，结构体方法返回错误的标准做法是将 error 作为最后一个返回值，并在调用处显式检查。要实现“统一捕获并返回 error”，关键不在于自动捕获（Go 没有 try/catch），而在于**约定一致的错误处理模式 + 封装共性逻辑**。
结构体方法签名统一返回 error
所有可能出错的方法都应以 error 为最后一个返回值，这是 Go 的惯用法：
type UserService struct{ /* ... */ }
func (u *UserService) CreateUser(name string) (int64, error) {
if name == "" {
return 0, fmt.Errorf("name cannot be empty")
}
// ... DB 插入逻辑
return 123, nil
}
func (u UserService) GetUser(id int64) (User, error) {
if id <= 0 {
return nil, errors.New("invalid user id")
}
// ... 查询逻辑
return &User{ID: id}, nil
}
调用时统一检查并透传 error
在上层方法（如 HTTP handler 或业务编排函数）中，使用 if err != nil 显式判断，并立即返回错误——避免忽略、避免嵌套过深：
- 用
return result, err直接透传，保持错误上下文清晰 - 必要时用
fmt.Errorf("xxx: %w", err)包裹错误（推荐），保留原始堆栈和语义 - 避免写
log.Fatal(err)或静默吞掉错误
封装通用错误处理逻辑（可选但实用）
若多个方法需相似的前置校验或后置处理，可提取为辅助函数或中间件风格包装：
立即学习“go语言免费学习笔记（深入）”；
// 校验 ID 并调用实际方法
func (u *UserService) SafeGetUser(id int64, fn func(int64) (*User, error)) (*User, error) {
if id <= 0 {
return nil, errors.New("id must be positive")
}
return fn(id)
}
// 使用
user, err := u.SafeGetUser(123, u.GetUser)
if err != nil {
return nil, err
}
更进一步，可结合接口（如 ServiceMethod[T any]）做泛型封装，但多数场景直接显式判断更清晰、易读、易调试。
HTTP 层统一错误响应（常见落地场景）
在 Web 服务中，常将 error 转为标准 JSON 响应。可定义统一响应结构，并在 handler 中集中处理：
type Resp[T any] struct {
Code int `json:"code"`
Msg string `json:"msg"`
Data T `json:"data,omitempty"`
}
func (h Handler) CreateUser(w http.ResponseWriter, r http.Request) {
var req struct{ Name string }
if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
writeError(w, 400, "invalid request: "+err.Error())
return
}
id, err := h.svc.CreateUser(req.Name)
if err != nil {
writeError(w, 500, "create user failed: "+err.Error())
return
}
writeJSON(w, Resp[int64]{Code: 200, Data: id})}
func writeError(w http.ResponseWriter, code int, msg string) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(code)
json.NewEncoder(w).Encode(Resp[any]{Code: code, Msg: msg})
}
这样就实现了“结构体方法返回 error → handler 统一捕获 → 标准化输出”，既符合 Go 的错误哲学，又满足业务对错误处理一致性的要求。
