定义统一错误响应结构包含状态码、消息等字段；2. 封装错误生成函数以标准化业务和系统错误；3. 使用中间件捕获panic并统一返回JSON格式错误；4. 控制器中主动调用统一错误返回；5. 集成日志记录与请求追踪便于排查。通过结构体、封装、中间件与日志协同实现一致错误处理。
在微服务架构中，统一错误响应能提升接口的可维护性和前端处理的一致性。Golang 中可以通过定义标准化的错误结构、封装错误处理逻辑，并结合中间件或拦截器实现全局统一响应。
定义统一的错误响应结构
首先，定义一个通用的响应格式，包含状态码、消息、错误详情等字段：
type ErrorResponse struct {
Code int `json:"code"`
Message string `json:"message"`
Data interface{} `json:"data,omitempty"`
Error string `json:"error,omitempty"`
}
这个结构可以用于所有失败返回，保持前后端交互格式一致。
封装错误生成与转换函数
通过封装函数将业务错误或系统错误转为统一格式：
func NewErrorResponse(code int, message, errDetail string) *ErrorResponse {
return &ErrorResponse{
Code: code,
Message: message,
Error: errDetail,
}
}
// 示例：常见错误类型
var ErrInvalidRequest = NewErrorResponse(400, "请求参数无效", "")
var ErrUnauthorized = NewErrorResponse(401, "未授权访问", "")
var ErrInternalServer = NewErrorResponse(500, "服务器内部错误", "")
业务逻辑中可以直接返回这些预定义错误，或根据需要动态构造。
使用中间件统一拦截和处理错误
在 HTTP 层使用中间件捕获 panic 或主动写入错误响应：
func ErrorMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
defer func() {
if err := recover(); err != nil {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(500)
json.NewEncoder(w).Encode(NewErrorResponse(500, "系统异常", fmt.Sprint(err)))
}
}()
next.ServeHTTP
(w, r)
})
}
(w, r)
})
}
在路由中注册该中间件，确保所有请求都经过统一错误处理。
控制器中主动返回错误示例：
if user == nil {
w.WriteHeader(404)
json.NewEncoder(w).Encode(NewErrorResponse(404, "用户不存在", ""))
return
}
集成日志与错误追踪
错误发生时记录上下文信息有助于排查问题。可以在返回错误前写入日志：
log.Printf("error: %s, path: %s, method: %s", errMsg, r.URL.Path, r.Method)
结合 request ID 可实现链路追踪，在分布式环境中快速定位问题。
基本上就这些。通过结构体定义、错误封装、中间件拦截和日志配合，Golang 微服务可以实现清晰、一致的错误响应机制。关键是避免裸写 http.Error 或直接 panic，始终走统一出口。
