如何用gRPC进行C++微服务开发？C++ RPC框架入门教程【分布式系统】

用 gRPC 做 C++ 微服务开发，核心是定义接口、生成桩代码、实现服务端逻辑、启动客户端调用——不依赖复杂中间件，靠 Protocol Buffers + HTTP/2 就能跑通轻量高并发的跨服务通信。

定义清晰的服务契约（.proto 文件）

所有 gRPC 通信始于一个 .proto 文件，它声明服务方法、请求响应结构和数据类型。这是服务间唯一共享的“协议”，必须严格版本管理。

• 用 service 块定义 RPC 方法，支持 unary（一问一答）、server streaming、client streaming 和 bidi streaming 四种模式
• 所有字段用 explicitly numbered 字段序号（如 1, 2），避免后续兼容问题
• 推荐把公共 message（如 ErrorDetail、Timestamp）抽到独立 proto 文件中，用 import 复用
• 示例片段：
  syntax = "proto3";
  package example;
  message GetUserRequest { string user_id = 1; }
  message User { string name = 1; int32 age = 2; }
  service UserService { rpc Get(GetUserRequest) returns (User); }

生成 C++ 桩代码并链接 gRPC 库

用 protoc 工具配合 gRPC 插件生成可直接编译的 C++ 类：服务基类（供你继承实现）、客户端 stub、序列化工具。

• 安装 protoc 和 grpc_cpp_plugin（Linux/macOS 可用 apt 或 brew；Windows 推荐 vcpkg）
• 命令示例：
  protoc --cpp_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` user.proto
• 生成 user.pb.h/.cc（data class）和 user.grpc.pb.h/.cc（service stub）
• CMake 中需链接 gRPC::grpc++、gRPC::grpc++_reflection（可选，用于调试）和 protobuf::libprotobuf

编写服务端：继承基类 + 启动 Server

你只需重写 service 基类中的纯虚函数，其余网络、线程、连接复用全由 gRPC runtime 管理。

• 实现类继承 UserService::Service，覆盖 Get 方法，参数为 ServerContext、request、response 和 callback
• 返回 Status::OK 表示成功；非 OK 状态会自动转成 HTTP/2 错误码和 gRPC 状态码（如 NOT_FOUND → 404）
• 用 ServerBuilder 配置监听地址、线程池（建议多线程 + CompletionQueue 模式）、TLS 证书（生产必需）
• 关键点：不要在 RPC handler 中做耗时同步操作（如 DB 查询），应异步回调或投递到 worker 线程池

编写客户端：创建 stub + 发起调用

客户端通过 Channel 连接服务端，再用 Channel 构造 stub，之后调用就像本地函数——但底层走的是 HTTP/2 流。

• Channel 支持负载均衡（如 round_robin）、健康检查、超时配置（channel arguments）
• unary 调用有同步（stub->Get(&context, req, &resp)）和异步（AsyncUnaryCall）两种方式；微服务推荐异步，避免线程阻塞
• 务必设置 deadline（如 5s），防止下游故障拖垮整个调用链
• 错误处理示例：
  if (status.ok()) { /* success */ }
  else { LOG(ERROR)

基本上就这些。gRPC 的 C++ 实现足够稳定，适合高性能微服务场景；难点不在框架本身，而在如何设计幂等接口、处理流控降级、集成 OpenTelemetry 埋点、以及和 Kubernetes Service DNS 对齐。起步阶段，先跑通一个 unary 服务，再逐步加 streaming、鉴权、重试策略。