使用Python paho-mqtt对接broker无法收到预期消息如何解决
问题排查与修复方案
一、问题定位方向
你遇到的情况可以从代码和broker两侧分别排查,首先代码存在明显的异步逻辑错误,其次也不排除broker侧有其他生产者推送消息的可能。
二、代码存在的问题及修复
paho-mqtt的client.connect()是异步执行方法,调用后不会立即完成连接,你直接在connect后执行订阅、发布操作,大概率此时TCP连接还未建立成功,订阅请求没有生效,也无法保证消息正确发送。
正确的写法是把订阅逻辑放到连接成功的on_connect回调中,确保连接建立完成后再执行相关操作,修复后代码如下:
import paho.mqtt.client as mqtt def on_connect(client, userdata, flags, rc): # 首先判断连接是否成功,rc=0为连接成功 if rc == 0: print("连接成功,返回码 {}".format(str(rc))) # 连接成功后再执行订阅 client.subscribe("login") print("已订阅login主题") # 订阅完成后再发布消息 client.publish("login","some_message") print("消息已发布") else: print("连接失败,返回码 {}".format(str(rc))) def on_message(client, userdata, message): print("收到消息: " ,str(message.payload.decode("utf-8"))) print("消息主题: ",message.topic) print("消息QoS: ",message.qos) print("消息保留标记: ",message.retain) # 创建客户端实例 client = mqtt.Client(client_id="random_id_name") print("客户端创建完成......") client.on_connect = on_connect client.on_message = on_message # 连接配置 hostname = "hostname_I_am_trying_to_connect" portnumber = 1883 # 替换为实际端口号 client.username_pw_set("username", "password") client.connect(host= hostname ,port= portnumber) print("尝试连接到 {} 端口 {}".format(hostname, portnumber)) client.loop_forever()
三、broker侧异常排查步骤
如果按上述代码修改后依然收到随机数字,可以按以下步骤验证是否为broker侧问题:
- 先注释掉代码中的
client.publish行,排除自己发布的消息干扰,确认收到的随机数字是否来自其他生产者 - 使用第三方MQTT客户端工具(如MQTTX、mosquitto_sub),使用相同的账号密码、连接地址接入broker,订阅
login主题- 如果工具也收到随机数字,说明是broker侧有其他生产者在往
login主题推送消息,和你的代码无关,需要对接broker管理员确认 - 如果工具收到的是你期望的
some_message/unique_id格式消息,则需要再检查你本地代码的连接配置、主题订阅规则是否正确
- 如果工具也收到随机数字,说明是broker侧有其他生产者在往
补充说明
如果你期望的消息是推送到login的子主题下(如login/xxx),需要将订阅规则改为client.subscribe("login/#"),使用通配符匹配所有子主题的消息。
内容的提问来源于stack exchange,提问作者shantanu rahut
相关产品推荐
相关产品推荐

