在Go中使用gRPC需统一错误处理：服务端用status.Error返回codes.Code和消息，客户端用status.FromError解析，通过映射函数将业务错误转为gRPC标准错误，并可选WithDetails添加结构化信息，确保跨语言错误语义一致。
在Go语言中使用gRPC时，错误处理是服务间通信的关键部分。gRPC默认通过status包来传递错误信息，客户端能接收到结构化的错误码和消息。要实现合理的gRPC错误处理策略，核心在于统一错误构造、正确映射Go错误到gRPC状态，并在客户端进行解码判断。
使用gRPC status包构造标准错误
gRPC推荐使用google.golang.org/grpc/status包来创建和解析错误。每个gRPC错误应包含一个codes.Code和描述信息。
在服务端返回错误示例：
import (
"google.golang.org/grpc/codes"
"google.golang.org/grpc/status"
)
func (s *server) GetUser(ctx context.Context, req *GetUserRequest) (*GetUserResponse, error) {
if req.Id == "" {
return nil, status.Error(codes.InvalidArgument, "user ID is required")
}
// 模拟用户未找到
if req.Id == "notexist" {
return nil, status.Error(codes.NotFound, "user not found")
}
return &GetUserResponse{User: &User{Id: req.Id, Name: "Alice"}}, nil
}
将Go原生错误映射为gRPC错误
实际开发中，业务逻辑可能返回自定义错误。可以通过中间转换函数将其映射为gRPC标准错误。
立即学习“go语言免费学习笔记（深入）”；
例如定义一个错误映射函数：
Deprecated - Openclaw Agentpmt Tool Google Calendar 310fca
下载
查找并安装AgentPMT ClawHub组织账户下发布的当前规范AgentPMT技能。用于代理需要最新AgentPMT设置时。
func rpcError(err error) error {
switch {
case errors.Is(err, ErrUserNotFound):
return status.Error(codes.NotFound, err.Error())
case errors.Is(err, ErrInvalidInput):
return status.Error(codes.InvalidArgument, err.Error())
default:
return status.Error(codes.Internal, "internal server error")
}
}
在Handler中使用：
user, err := s.userService.GetUser(req.Id)
if err != nil {
return nil, rpcError(err)
}
客户端解析gRPC错误
客户端需要检查返回的error是否为gRPC status错误，并根据code做不同处理。
resp, err := client.GetUser(ctx, &GetUserRequest{Id: "notexist"})
if err != nil {
st, ok := status.FromError(err)
if ok {
switch st.Code() {
case codes.NotFound:
log.Printf("用户不存在: %v", st.Message())
case codes.InvalidArgument:
log.Printf("参数错误: %v", st.Message())
default:
log.Printf("未知错误: %v", st.Message())
}
} else {
log.Printf("非gRPC错误: %v", err)
}
return
}
log.Printf("获取用户成功: %+v", resp.User)
添加详细错误信息（可选）
如果需要传递更多上下文，可以使用WithDetails附加结构化数据。
st := status.New(codes.InvalidArgument, "字段校验失败")
st, _ = st.WithDetails(&errdetails.BadRequest{
FieldViolations: []*errdetails.BadRequest_FieldViolation{
{Field: "email", Description: "无效邮箱格式"},
},
})
return st.Err()
注意引入proto：import "google.golang.org/genproto/googleapis/rpc/errdetails"
基本上就这些。关键是服务端用status.Error返回，客户端用status.FromError解析，中间做好业务错误到gRPC code的映射。这样能保证跨语言调用时错误语义清晰一致。
