编译安装librdkafka后需执行sudo ldconfig或设置ld_library_path，否则运行时报librdkafka.so.1找不到；关键配置bootstrap.servers、message.send.max.retries、dr_msg_cb等不可遗漏；消费者必须显式设置group.id和auto.offset.reset；poll()返回null是正常现象，非错误。
怎么编译安装librdkafka才能不报librdkafka.so.1: cannot open shared object file
这是 C++ 项目链接成功但运行时直接崩溃的最常见原因——系统根本找不到动态库。不是没装，是没“认到”。
-
make install默认装到/usr/local/lib，但多数 Linux 发行版默认不查这个路径 - 必须手动把路径写进动态链接器配置：
echo "/usr/local/lib" | sudo tee -a /etc/ld.so.conf - 然后立刻执行
sudo ldconfig，否则改了等于白改 - 如果用的是非 root 环境（比如容器或 CI），别碰
/etc/ld.so.conf，改用LD_LIBRARY_PATH=/usr/local/lib ./your_app
创建生产者时rd_kafka_conf_set哪些参数不能漏
漏掉关键配置项会导致连接失败、消息静默丢弃、或卡死在 rd_kafka_new()，且无明确错误提示。
-
bootstrap.servers必须设，哪怕只连一个 broker；多个地址用逗号分隔，如"localhost:9092,192.168.1.10:9092" -
message.send.max.retries建议设为"5"，默认 2 次太激进，网络抖动就失败 -
queue.buffering.max.ms和batch.num.messages要配合调：想低延迟就设"1"ms + 小 batch；想吞吐就设"10"ms + 大 batch - 务必设置
dr_msg_cb回调（用rd_kafka_conf_set_dr_msg_cb），否则你永远不知道消息到底发没发出去
消费者拉不到消息？先检查group.id和auto.offset.reset
90% 的“收不到消息”问题都出在这两个配置上，而不是 Kafka 服务或 Topic 本身。
-
group.id是消费者身份标识，同一组内多个实例自动负载均衡；但如果 ID 每次都随机生成，就相当于每次都是新组，Kafka 默认从最新 offset 开始消费（即丢掉历史消息） -
auto.offset.reset必须显式设为"earliest"或"latest"；不设的话，librdkafka 会 fallback 到"latest"，而你测试时往往想看已存在的数据 - 首次启动消费者后，Kafka 会在
__consumer_offsets主题里存位移；如果 broker 配置了offsets.topic.replication.factor=1但只起一个 broker，位移提交可能失败，导致下次启动又从头开始
为什么poll()返回空指针却没报错
librdkafka 的 rd_kafka_consumer_poll() 返回 NULL 是完全合法的常态，不代表出错，也不代表没消息——它只表示“当前没有可用消息”，尤其在刚启动或消息稀疏时。
立即学习“C++免费学习笔记（深入）”；
- 不要把
NULL当作错误处理，更不该exit(1)或抛异常 - 正确做法是循环调用
poll()，并检查返回值是否为rd_kafka_message_t*；只有当msg->err != RD_KAFKA_RESP_ERR_NO_ERROR才是真错误 - 如果持续返回
NULL超过预期时间（比如 5 秒），再检查rd_kafka_last_error()或启用debug=cgrp,topic日志级别排查订阅状态
poll() 的空返回当成错误——这些点不亲手踩一遍，文档里都像废话。 
