c++ gRPC框架入门与使用_c++微服务RPC通信实战【教程】

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

c++ gRPC框架入门与使用_c++微服务RPC通信实战【教程】

2025-12-06

浏览次数：次

返回列表

gRPC是C++微服务最主流高效的选择，需按“定义.proto→编译生成代码→实现服务端/客户端→启动”主线推进，依赖protoc、gRPC库、CMake及C++14+编译器。

c++ grpc框架入门与使用_c++微服务rpc通信实战【教程】

想用 C++ 做微服务，gRPC 是目前最主流、最高效的选择之一。它基于 Protocol Buffers（protobuf）定义接口，自动生成跨语言的客户端和服务端代码，天然支持 HTTP/2、流式通信、认证和负载均衡等能力。入门不难，但关键要理清“定义 → 编译 → 实现 → 启动”这条主线。

一、环境准备：装好核心工具链

gRPC 不是单纯一个库，而是一套工具链。C++ 项目需要几个基础组件：

Protobuf 编译器（protoc）：用于把 .proto 文件编译成 C++ 头文件和源码；
gRPC C++ 库：含运行时、Channel、Stub、Server 等核心类；
CMake（推荐）：gRPC 官方示例和现代项目基本都用 CMake 管理依赖和构建；
支持 C++14 或更高版本的编译器（如 GCC 7+ / Clang 5+ / MSVC 2019+）。

Mac 用户可用 brew install protobuf grpc；Linux 推荐从源码编译或用包管理器安装对应开发包（如 libgrpc-dev）；Windows 可用 vcpkg：vcpkg install grpc:x64-windows。

二、写一个最简 .proto 文件并生成代码

先定义一个叫 hello.proto 的服务：

syntax = "proto3";
package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

然后用 protoc 生成 C++ 代码：

protoc --cpp_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_cpp_plugin` hello.proto

会生成 hello.pb.h、hello.pb.cc、hello.grpc.pb.h、hello.grpc.pb.cc 四个文件。它们分别提供数据结构（protobuf）和 RPC 接口（gRPC Stub/Service）。

简小派

简小派是一款AI原生求职工具，通过简历优化、岗位匹配、项目生成、模拟面试与智能投递，全链路提升求职成功率，帮助普通人更快拿到更好的 offer。

123 查看详情简小派

三、实现服务端与客户端（同步方式）

服务端继承自自动生成的 Greeter::Service，重写 SayHello 方法；客户端用 Greeter::Stub 调用远程方法。

服务端关键步骤：创建 ServerBuilder → 注册服务实例 → 调用 BuildAndStart() → Wait() 阻塞运行；
客户端关键步骤：用 grpc::CreateChannel() 连接地址 → 用 Greeter::NewStub() 创建 stub → 调用 SayHello()（同步调用会阻塞直到响应返回）；
注意传参和返回值类型：必须用生成的 HelloRequest 和 HelloReply 类型，不是普通 string。