统一错误处理需定义标准错误模型、封装调用逻辑、使用中间件捕获异常。1. 定义含错误码、消息等字段的通用Error结构并置于公共模块；2. 封装HTTP/gRPC客户端，统一处理网络错误并映射为预设错误类型；3. 在Gin或gRPC拦截器中实现panic恢复并返回标准化错误响应；4. 通过Context传递trace ID等上下文信息，结合wrap error和结构化日志实现错误链追踪。核心是各服务遵循相同规则，确保错误可查可控。
在微服务架构中，Go语言常用于构建高性能的服务节点。当多个服务之间频繁调用时，错误处理容易变得分散且不一致。要实现统一的错误处理机制，关键在于标准化错误定义、封装调用逻辑、使用中间件或拦截器捕获异常，并确保跨服务边界的信息传递清晰可控。
定义统一的错误模型
为了让所有微服务对错误有一致的理解，首先要定义通用的错误结构。通常包含错误码、消息、详情和时间戳等字段：
type Error struct {
Code int `json:"code"`
Message string `json:"message"`
Detail string `json:"detail,omitempty"`
Time string `json:"time,omitempty"`
}
建议将这类错误结构放在公共模块（如 common/errors）中，供所有服务引入。通过预设错误码（如 1001 表示参数无效，2001 表示远程调用失败），提升排查效率。
封装 HTTP/gRPC 客户端调用逻辑
直接裸调远程接口会把错误处理散落在各处。应通过封装客户端，在调用层集中处理网络错误、超时、反序列化失败等情况：
立即学习“go语言免费学习笔记（深入）”；
- 在发起请求后统一检查响应状态码或 gRPC 状态码
- 将原始错误映射为预定义的业务错误类型
- 添加日志记录与监控埋点，便于追踪链路问题
例如，在 HTTP 调用中可编写一个通用的 DoRequest 方法：
【极品模板】出品的一款功能强大、安全性高、调用简单、扩展灵活的响应式多语言企业网站管理系统。 产品主要功能如下： 01、支持多语言扩展（独立内容表，可一键复制中文版数据） 02、支持一键修改后台路径； 03、杜绝常见弱口令，内置多种参数过滤、有效防范常见XSS； 04、支持文件分片上传功能，实现大文件轻松上传； 05、支持一键获取微信公众号文章（保存文章的图片到本地服务器）； 06、支持一键
func DoRequest(client *http.Client, req *http.Request) (*Response, error) {
resp, err := client.Do(req)
if err != nil {
return nil, WrapError(ErrCallFailed, "http call failed", err.Error())
}
defer resp.Body.Close()
if resp.StatusCode >= 400 {
var apiErr common.Error
json.NewDecoder(resp.Body).Decode(&apiErr)
return nil, &apiErr
}
// 正常解析
}
使用中间件统一处理入口错误
对于接收其他服务调用的微服务，可在路由层或 RPC 拦截器中加入错误恢复机制。比如 Gin 框架中使用中间件：
func ErrorHandler() gin.HandlerFunc {
return func(c *gin.Context) {
defer func() {
if r := recover(); r != nil {
log.Printf("panic: %v", r)
c.JSON(500, common.Error{
Code: 9999,
Message: "internal server error",
Time: time.Now().Format(time.RFC3339),
})
}
}()
c.Next()
}
}
gRPC 中可通过 unary interceptor 实现类似功能，拦截所有入站请求，捕获 panic 并返回标准错误响应。
跨服务传递上下文与错误信息
微服务间调用时，应通过 Context 传递 trace ID、用户身份等信息，有助于错误溯源。同时，在封装错误时保留原始错误原因，形成错误链：
例如：
err = fmt.Errorf("failed to fetch user: %w", rpcErr)
logger.Error("call failed", zap.Error(err), zap.String("trace_id", getTraceID(ctx)))
基本上就这些。统一处理微服务错误的核心不是写得多复杂，而是让每个服务都遵循相同的规则——定义清楚、封装到位、日志可查。这样哪怕系统变大，出问题也能快速定位，不至于陷入“谁报的错都不知道”的局面。
