定义统一响应结构，包含状态码、消息和数据；2. 封装Success和Error函数简化返回；3. 使用AppError自定义错误类型；4. 通过Handle中间件统一处理错误输出；5. 集中管理错误码常量，提升可维护性。
在Golang的简单项目中，接口错误统一处理能提升代码可读性和维护性。核心思路是定义一致的错误响应格式，通过中间件或封装函数集中处理错误返回，避免在每个接口中重复写错误输出逻辑。
定义统一的响应结构
所有接口返回使用相同的结构，便于前端解析。常见结构包含状态码、消息和数据：
type Response struct {
Code int `json:"code"`
Msg string `json:"msg"`
Data interface{} `json:"data,omitempty"`
}
例如成功返回：{ "code": 0, "msg": "ok", "data": { ... } }，错误返回：{ "code": 1001, "msg": "参数错误" }。
封装公共返回方法
在工具包中提供便捷函数，简化控制器中的返回操作：
立即学习“go语言免费学习笔记（深入）”；
func Success(data interface{}) *Response {
return &Response{Code: 0, Msg: "ok", Data: data}
}
func Error(code int, msg string) *Response {
return &Response{Code: code, Msg: msg}
}
在HTTP处理函数中直接使用：
if name == "" {
return Error(400, "缺少用户名")
}
自定义错误类型与中间件处理
定义项目内错误类型，如：
type AppError struct {
Code int
Msg string
}
func (e AppError) Error() string {
return e.Msg
}
在关键处理流程中返回自定义错误。可配合中间件捕获panic或错误值，统一输出JSON错误响应。例如用装饰器包装handler：
func Handle(h func(http.ResponseWriter, *http.Request) error) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
err := h(w, r)
if err != nil {
var appErr AppError
if errors.As(err, &appErr) {
json.NewEncoder(w).Encode(Error(appErr.Code, appErr.Msg))
} else {
json.NewEncoder(w).Encode(Error(500, "系统错误"))
}
return
}
}
}
这样业务逻辑中只需返回错误，由框架层统一处理输出。
常见错误码集中管理
将错误码定义为常量或变量，提升可维护性：
const (
ErrInvalidParam = iota + 1000
ErrUnauthorized
ErrServerInternal
)
使用时清晰明确：
if user == nil {
return AppError{Code: ErrUnauthorized, Msg: "用户未登录"}
}
基本上就这些。简单项目不需要复杂框架，通过结构封装和错误包装就能实现干净的错误处理逻辑。关键是保持返回格式一致，减少重复代码。
