RocketMQ 是阿里开源低延迟、高吞吐、高可靠分布式消息中间件,广泛用于流量削峰、异步解耦、分布式事务、实时日志采集、游戏网关异步通信等场景。
Java 生态 SDK 资料丰富,但高性能 C++ 网关、存储服务、边缘计算、大数据采集服务只能使用官方 rocketmq-client-cpp。 其核心优势:无 JVM 依赖、内存占用极低、端到端延迟稳定毫秒级,是高并发 C++ 服务接入消息队列的首选方案。
本文覆盖基础生产者 / 消费者全套使用,并落地三大企业生产刚需能力完整可编译代码:
同时包含同步 / 异步 / 批量 / 顺序 / 事务消息、Tag 过滤、参数调优、业务场景选型、线上踩坑指南,全部代码可直接编译上线。
一、RocketMQ C++ SDK 基础介绍
1.1 什么是 rocketmq-client-cpp
Apache RocketMQ 官方维护跨平台 C++ 客户端,基于私有 TCP 协议通信,完全脱离 Java 环境,支持 Linux/macOS,是 C++ 服务接入 RocketMQ 唯一官方标准客户端。
1.2 完整支持能力清单
基础消息能力
- 同步发送、异步发送、单向发送
- 批量消息发送、分区顺序消息
- 事务消息(半消息 + 事务回查,分布式最终一致性)
- Tag 标签过滤、自定义消息属性
生产高可用能力
- NameServer 多节点集群自动故障切换
- 消费失败自动重试、死信队列 DLQ 完整处理
- 全局单例客户端封装,连接复用,无端口泄漏
消费能力
- 并发批量消费、自定义消费线程数
- 消费超时控制、最大重试次数自定义
1.3 C++ SDK 核心优势
二、环境搭建与 CMake 工程配置
2.1 Linux 系统依赖安装
sudo apt update
sudo apt install libssl-dev libcurl4-openssl-dev libjsoncpp-dev git cmake -y
2.2 编译安装 RocketMQ C++ SDK
git clone https://github.com/apache/rocketmq-client-cpp.git
cd rocketmq-client-cpp
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j8
sudo make install
2.3 CMakeLists.txt 完整配置
cmake_minimum_required(VERSION 3.16)
project(rocketmq_cpp_demo)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
# 头文件、系统库路径
include_directories(/usr/local/include)
link_directories(/usr/local/lib)
add_executable(rocketmq_demo main.cpp)
# 链接依赖库
target_link_libraries(rocketmq_demo
rocketmq
pthread
curl
ssl
jsoncpp
)
三、基础生产者 & 消费者示例
3.1 同步可靠发送(订单 / 支付核心业务)
阻塞等待 Broker 确认,保证消息 100% 投递成功,金融、订单核心链路首选。
#include <iostream>
#include <string>
#include <chrono>
#include <thread>
#include <vector>
#include \”rocketmq/DefaultMQProducer.h\”
#include \”rocketmq/DefaultMQPushConsumer.h\”
#include \”rocketmq/SendCallback.h\”
#include \”rocketmq/TransactionListener.h\”
using namespace rocketmq;
void SyncSendMsg()
{
DefaultMQProducer producer(\”cpp_producer_group\”);
producer.setNamesrvAddr(\”127.0.0.1:9876\”);
producer.setSendMsgTimeout(3000);
producer.start();
std::string topic = \”cpp_test_topic\”;
Message msg(topic, \”同步可靠消息:订单创建\”);
SendResult res = producer.send(msg);
std::cout << \”发送状态:\” << res.getSendStatus() << \” MsgId:\” << res.getMsgId() << std::endl;
producer.shutdown();
}
3.2 异步高吞吐发送(日志 / 埋点)
不阻塞业务线程,高吞吐场景使用,必须实现回调捕获失败消息。
class AsyncSendCallback : public SendCallback
{
public:
void onSuccess(SendResult& res) override
{
std::cout << \”异步发送成功 MsgId:\” << res.getMsgId() << std::endl;
}
void onException(MQException& e) override
{
std::cerr << \”异步发送异常:\” << e.what() << std::endl;
}
};
void AsyncSendMsg()
{
DefaultMQProducer producer(\”cpp_producer_group\”);
producer.setNamesrvAddr(\”127.0.0.1:9876\”);
producer.start();
Message msg(\”cpp_test_topic\”, \”用户行为埋点异步消息\”);
static AsyncSendCallback cb;
producer.send(msg, &cb);
std::this_thread::sleep_for(std::chrono::seconds(1));
producer.shutdown();
}


![P11246 [GESP202409 六级] 小杨和整数拆分-171主机测评](https://www.171host.com/wp-content/uploads/2026/11/20261108100631-6af049a75855c-220x150.png)

