正确处理gRPC错误需使用status.Error返回状态码，如InvalidArgument表示参数错误，NotFound表示资源不存在，并在客户端用status.FromError解析，确保错误语义清晰。
在 Golang 的 gRPC 服务开发中，正确处理错误并返回合适的错误状态码，是保证客户端能准确理解服务端异常情况的关键。gRPC 使用 status 包来定义标准的错误码，并通过 google.golang.org/grpc/status 提供操作接口。
gRPC 标准错误码（gRPC Status Code）
gRPC 定义了一组跨语言通用的状态码，位于 codes.Code 枚举中。常用的包括：
- OK：操作成功（一般不用于错误）
- InvalidArgument：请求参数错误（如字段校验失败）
- NotFound：请求资源不存在
- AlreadyExists：资源已存在（如重复创建）
- PermissionDenied：权限不足
- Unauthenticated：未认证（身份验证失败）
- FailedPrecondition：前置条件不满足
- Unavailable：服务暂时不可用
- Internal：内部错误（如 panic、未预期的异常）
- Unimplemented：方法未实现
在服务端返回错误
使用 status.Errorf 构造带有状态码和消息的错误，然后直接返回。gRPC 框架会自动将其序列化并通过 wire 传输。
func (s *UserService) GetUser(ctx context.Context, req *pb.GetUserRequest) (*pb.User, error) { if req.Id == "" { return nil, status.Error(codes.InvalidArgument, "user ID is required") } user, err := s.db.FindUser(req.Id) if err != nil { if errors.Is(err, sql.ErrNoRows) { return nil, status.Error(codes.NotFound, "user not found") } // 其他数据库错误视为内部错误 return nil, status.Error(codes.Internal, "internal error") } return &pb.User{Name: user.Name}, nil }客户端解析错误
客户端收到响应错误时，应使用 status.FromError 来提取状态码和消息。
立即学习“go语言免费学习笔记（深入）”；
resp, err := client.GetUser(ctx, &pb.GetUserRequest{Id: "123"}) if err != nil { st, ok := status.FromError(err) if !ok { log.Println("非 gRPC 错误:", err) return } switch st.Code() { case codes.NotFound: log.Println("用户不存在:", st.Message()) case codes.InvalidArgument: log.Println("参数错误:", st.Message()) default: log.Printf("未知错误: %v", st.Message()) } return } // 成功处理 resp
自定义错误映射（可选）
若业务中使用了自定义错误类型，可通过中间件或封装函数统一映射为 gRPC 状态码。例如：
func errorToStatus(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()) case errors.Is(err, ErrUnauthorized): return status.Error(codes.Unauthenticated, err.Error()) default: // 非预期错误标记为 Internal log.Printf("internal error: %v", err) return status.Error(codes.Internal, "internal error") } }这样可以在业务逻辑中使用清晰的错误类型，最后统一转换为 gRPC 兼容的错误格式。
基本上就这些。关键是用好 status.Error 和 status.FromError，并根据语义选择合适的状态码，避免所有错误都返回 Internal 或 InvalidArgument。规范的错误处理能让 API 更易用、更健壮。
