统一定义RPC错误类型，使用结构化错误码与消息，结合重试机制、上下文超时控制及链路追踪，提升微服务稳定性与可维护性。
在微服务架构中，服务间通过RPC（远程过程调用）进行通信。由于网络不稳定、服务宕机或参数错误等原因，RPC调用很容易出现异常。Golang因其高并发和简洁的语法，被广泛用于构建微服务，但如何优雅地处理RPC错误是保障系统稳定的关键。
统一错误定义与传递
不同服务之间需要对错误进行标准化定义，避免因错误信息不一致导致上层逻辑难以判断。建议使用结构化的错误类型，例如自定义错误码和消息。
可以在公共库中定义通用错误：
type RPCError struct {
Code int `json:"code"`
Message string `json:"message"`
Detail string `json:"detail,omitempty"`
}
<p>func (e *RPCError) Error() string {
return e.Message
}</p><p>// 预定义错误
var (
ErrUserNotFound = &RPCError{Code: 404, Message: "用户不存在"}
ErrInvalidParam = &RPCError{Code: 400, Message: "参数无效"}
ErrServiceBusy = &RPCError{Code: 503, Message: "服务繁忙，请稍后重试"}
)
在gRPC等框架中，可通过status包将错误编码到metadata中，确保跨服务可解析。
立即学习“go语言免费学习笔记（深入）”；
客户端错误重试机制
网络抖动或临时故障可能导致RPC失败，加入合理的重试策略能提升系统容错能力。
- 使用指数退避策略，避免频繁重试加重服务负担
- 对可重试错误（如超时、503）才进行重试，4xx类错误通常不应重试
- 限制最大重试次数，防止无限循环
示例代码：
func CallWithRetry(fn func() error, maxRetries int) error {
var err error
for i := 0; i <= maxRetries; i++ {
err = fn()
if err == nil {
return nil
}
// 判断是否可重试
if !isRetryable(err) {
return err
}
if i < maxRetries {
time.Sleep(time.Millisecond * time.Duration(100*<<i)) // 指数退避
}
}
return err
}
上下文超时与链路追踪
使用context控制RPC调用的生命周期，防止长时间阻塞。
- 每个RPC调用都应设置合理的超时时间
- 通过context传递trace ID，便于日志关联和问题排查
- 上游超时应主动取消下游调用，避免资源浪费
示例：
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
<p>// 注入trace id
ctx = context.WithValue(ctx, "trace_id", generateTraceID())</p><p>resp, err := client.GetUser(ctx, &GetUserRequest{Id: 123})
if err != nil {
log.Printf("RPC调用失败: %v, trace_id=%v", err, ctx.Value("trace_id"))
return err
}
服务端错误日志与监控
服务端需清晰记录错误日志，并对接监控系统。
- 记录错误发生时间、调用方法、参数摘要、错误类型
- 敏感信息如密码、token需脱敏
- 关键错误上报至Prometheus或ELK，便于告警
建议结合zap、logrus等结构化日志库输出JSON格式日志，方便收集分析。
基本上就这些。合理设计错误处理机制，能让微服务更健壮，排查问题更高效。关键是统一规范、明确语义、及时反馈。不复杂但容易忽略。
