10分钟上手bRPC：C++高性能RPC框架实战指南

10分钟上手bRPC：C++高性能RPC框架实战指南

【免费下载链接】brpcbrpc is an Industrial-grade RPC framework using C++ Language, which is often used in high performance system such as Search, Storage, Machine learning, Advertisement, Recommendation etc. "brpc" means "better RPC".项目地址: https://gitcode.com/GitHub_Trending/brpc/brpc

bRPC（better RPC）是一个用 C++ 编写的工业级 RPC 框架，主打高并发下的低延迟，常用于搜索、存储、推荐这类对性能敏感的 C++ 服务。如果你手头有一个需要频繁互相调用的 C++ 微服务集群，它可以帮你把网络通信、连接管理、负载均衡这些脏活一次干完。

bRPC和libcurl、官方client到底差在哪

先说结论：bRPC的核心价值不是"又一个RPC协议"，而是把多个协议和客户端收敛到同一个事件循环和同一套线程模型里。

• 一个端口多协议：同一个 Server 可以同时暴露 protobuf RPC、HTTP、gRPC，甚至访问 redis、memcached、thrift，不用在进程里塞好几套互不兼容的网络栈。
• 客户端访问方式齐全：同步、异步、半同步都有，复杂的多目标并发访问还有 Combo Channel 帮你把"先查A再并发查B和C"写成几行代码。
• 内置调试通道：服务跑起来自带一套 HTTP 内置接口，能看状态、看连接、看最近每次调用的延时，排障不用先挂 profiler。

三步跑通bRPC第一个demo

以仓库里的 example/echo_c++ 为例，全程三步，参考 docs/cn/getting_started.md。

第一步：装依赖，编译框架本体

sudo apt-get install -y g++ make libssl-dev libgflags-dev \ libprotobuf-dev libprotoc-dev protobuf-compiler libleveldb-dev sh config_brpc.sh --headers=/usr/include --libs=/usr/lib make -j8

第二步：编译 echo 示例

cd example/echo_c++ make

第三步：起服务，发请求

./echo_server & ./echo_client

client 输出里能看到收到的回显内容，说明一次完整的 bRPC 调用（建连、序列化、处理、回复）已经走通。想试别的场景，example/ 目录里还有 http_c++、grpc_c++、redis_c++、coroutine 等现成例子，每个都是独立可编译的小工程。

一次真实排查场景：慢调用怎么定位

假设线上有台 bRPC 服务的偶发慢请求，你可以这样走一遍。

• 先打开服务的内置接口，/status看整体状态，/connections看连接情况，这些端点服务启动后就自动挂上，不用额外部署监控组件。
• 再到/rpcz页面翻最近的调用记录，每次 RPC 的耗时、请求和回复大小、错误码都列在那里，直接就能定位到是哪些 span 慢了。
• 如果是 CPU 打满型的问题，/hotspots能直接抓 CPU 火焰图，配合 docs/cn/cpu_profiler.md 的思路定位热点函数。

上手前两条避坑提示

• 别把阻塞操作塞进 bthread：bRPC 的请求处理跑在用户态轻量线程 bthread 上，写阻塞文件 IO、同步 sleep 这类操作会卡住所在 worker，文档里 bthread or not 专门讲了什么时候该用 bthread、什么时候退回 pthread。
• 超时和重试要显式配：client 侧建议显式设置 timeout_ms 和 max_retry，否则连接抖动时请求会按默认策略挂着等，具体字段见 docs/cn/client.md。

下一步：克隆仓库git clone https://gitcode.com/GitHub_Trending/brpc/brpc，打开 docs/cn/overview.md 读一遍框架全貌，再按上面的步骤把 echo 示例跑起来。

【免费下载链接】brpcbrpc is an Industrial-grade RPC framework using C++ Language, which is often used in high performance system such as Search, Storage, Machine learning, Advertisement, Recommendation etc. "brpc" means "better RPC".项目地址: https://gitcode.com/GitHub_Trending/brpc/brpc