rocketmq 环境配置[python]
因本人是 python 开发，macbook 开发。windows 可以采取配置远程 linux 解释器或者 pycharm 专业版的 docker 解释器进行开发
M1 芯片 本地运行 rocketmq
rocketmq Python 开源地址：
https://github.com/apache/rocketmq-client-python
因为需要 linux c/c++ libs包，官方只给出了centos ,debain,macOS 配置信息
终端使用 brew install wget 命令 【注意代理/或开启 tun 模式】
• x86_64 架构的 librocketmq.dylib
wget <https://github.com/apache/rocketmq-client-cpp/releases/download/2.0.0/rocketmq-client-cpp-2.0.0-bin-release.darwin.tar.gz>
tar -xzf rocketmq-client-cpp-2.0.0-bin-release.darwin.tar.gz
cd rocketmq-client-cpp
sudo mkdir /usr/local/include/rocketmq
sudo mkdir -p /usr/local/lib
sudo cp include/* /usr/local/include/rocketmq
sudo cp lib/* /usr/local/lib>>>>>修正动态库 ID（macOS 的 install_name_tool）
>>>>>这一步是为了确保 Python 在加载 .dylib 时不出错（macOS 默认路径检查严格）sudo install_name_tool -id "@rpath/librocketmq.dylib" /usr/local/lib/librocketmq.dylib
上面会把 librocketmq.dylib 安装到 /usr/local/lib/，让动态链接器可以找到它
为了避免后续找不到 .dylib
- 确保文件放到了 /usr/local/lib/librocketmq.dylib [✅ 添加链接路径到系统环境变量]
vim ~/.zshrc
echo 'export DYLD_LIBRARY_PATH="/usr/local/lib:$DYLD_LIBRARY_PATH"' >> ~/.zshrc
source ~/.zshrc
验证：
ls /usr/local/lib/librocketmq.dylib
由于 mac 都是 m1芯片的，Intel x86 的可以忽略该操作。
否则使用 arm 架构的有这个错误！！！！
OSError: ... is an incompatible architecture (have 'x86_64', need 'arm64e' or 'arm64')
- 使用 Rosetta 启动终端（右键 iTerm → “使用 Rosetta 打开”）【显示简介】
https://cdn.jsdelivr.net/gh/jacinli/image-hosting@main/notes/202505161413677.png
点击显示简介
x86_64 的 conda 环境：
CONDA_SUBDIR=osx-64 conda create -n rocketmq-x86 python=3.10
conda activate rocketmq-x86>>>>>>>
python -c "import platform; print(platform.machine())"
>>>>>
x86_64
安装依赖：
pip install rocketmq-client-python
验证操作：
python -c "import platform; print(platform.machine())"验证成功：
from rocketmq.client import Producer
print("RocketMQ 启动成功 ✅")
上面就表示已经成功导入。
如果是本地运行，请使用腾讯云 mq 公网地址
【无法使用 arm 架构的 librocketmq.dylib 】
这个前提是：官方有提供 ARM 架构的 RocketMQ C++ SDK，但很遗憾：
🔥 截止目前（2025），Apache 官方只提供了
x86_64 的 Darwin 版本
⚠️ 没有 ARM64 架构的 .dylib，所以你
无法直接在 M1 的原生 Python 上运行
腾讯云rocketmq 配置
因为这个和其他的不太一样
| 项目 | 腾讯云 RocketMQ |
|---|---|
| NameServer 地址 | 是腾讯云提供的专属地址，例如 rmq-cn-xxx.rmq.cloud.tencent.com:8080 |
| Topic | 必须先在 腾讯云控制台创建 Topic |
| Group、权限等 | 都要在控制台配置或授权 |
| 自动创建 Topic | ❌ 不支持（和 Apache 的 autoCreateTopic=true 不一样） |
在控制台 先创建 topic :创建名为 dev-test-mq-for-0516 的 Topic
然后发送测试消息 【这样保证域名能被解析到】
rocketmq.exceptions.ProducerSendSyncFailed: No route info of this topic: dev-test-mq-for-0516
如果有这个错误 可以看一下 自己的集群 地址，看看本地开发到底是公网还是私网地址，这个很重要！！！！
可以创建一个 group 来测试。
在腾讯云操作上必须要创建 topic group 现有这两个，才可以进行消费与生产！！！！！
❗这是最关键的一步！否则客户端永远查不到路由。
请这样操作：
- 打开控制台 ➝ RocketMQ 实例 ➝ Topic 管理 ➝ 点进 dev-test-mq-for-0516
- 查看 队列数量 是不是 0？（你之前看到是 3，但如果不是绑定在你当前集群的 Broker 上，也等于没用）
- 点右侧「编辑」
- 重新设置队列数量为 3（或其他），然后点保存提交
这样就会重新绑定路由到 Broker。
回到 Topic 管理 ➝ 点 发送测试消息，填点消息内容，发送一下。
这个过程就会刷新 NameServer 的路由缓存。
可以测一测网络信息，以免是网络
telnet rmq-xxxx.rocketmq.gz.qcloud.tencenttdmq.com 8080ping rmq-xxxx.rocketmq.gz.qcloud.tencenttdmq.com
腾讯云的 RocketMQ 默认是 VPC 专网访问，如果你本地是公网，要配置公网访问地址，并且：
- 对应账号要开启公网访问权限
- SDK 需要用公网域名
- AK/SK 权限配置正确