下载最新release版本, 稳定性好, 网址链接。
一、解压源码包
# 解压到当前目录
tar -xzvf brpc-1.12.1.tar.gz# 进入解压后的目录
cd brpc-1.12.1
二、安装编译依赖(Ubuntu/Debian)
sudo apt update
sudo apt install -y g++ make cmake libssl-dev libgflags-dev libprotobuf-dev protobuf-compiler
三、编译 BRPC
1. 创建构建目录
mkdir build && cd build
2. 配置 CMake
cmake .. \-DCMAKE_INSTALL_PREFIX=/usr/local \-DBUILD_SHARED_LIBS=ON \-DWITH_DEBUG_SYMBOLS=OFF \-DCMAKE_POLICY_VERSION_MINIMUM=3.5
3. 编译并安装
make -j$(nproc) # 多线程编译
sudo make install # 安装到系统目录
sudo ldconfig # 更新库缓存
四、验证安装是否成功
1. 检查关键文件
# 检查头文件
ls /usr/local/include/brpc/*.h# 检查库文件
ls /usr/local/lib/libbrpc.so# 检查 CMake 配置
ls /usr/local/lib/cmake/BRPC/BRPCConfig.cmake
2. 运行测试示例
# 进入示例目录
cd ../example/echo_c++# 编译并运行服务端
make
./echo_server# 另开终端运行客户端
./echo_client
输出应为:
Received: Hello BRPC!
五、集成到你的项目(示例)
1. 创建测试文件 test_brpc.cpp
#include <brpc/server.h>
#include <iostream>int main() {brpc::Server server;if (server.Start(8000, nullptr) == 0) {std::cout << "BRPC server started successfully!" << std::endl;server.RunUntilAskedToQuit();} else {std::cerr << "Failed to start BRPC server" << std::endl;return -1;}return 0;
}
2. 创建 CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(test_brpc)find_package(BRPC REQUIRED)
find_package(Protobuf REQUIRED)add_executable(test_brpc test_brpc.cpp)
target_link_libraries(test_brpc ${BRPC_LIB} pthread)
3. 编译并运行
mkdir build && cd build
cmake .. && make
./test_brpc # 应输出 "BRPC server started successfully!"
六、常见问题解决
1. 编译时报错找不到头文件
# 确保安装路径正确
sudo rm -rf /usr/local/include/brpc /usr/local/lib/libbrpc*
cd brpc-1.12.1/build
sudo make install
sudo ldconfig
2. 运行时提示 libbrpc.so 未找到
# 临时生效
export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH# 永久生效
echo "export LD_LIBRARY_PATH=/usr/local/lib:\$LD_LIBRARY_PATH" >> ~/.bashrc
source ~/.bashrc
3. 测试示例失败
检查服务端和客户端是否使用相同协议:
// 服务端和客户端需一致
brpc::ChannelOptions options;
options.protocol = brpc::PROTOCOL_BAIDU_STD; // 默认协议