You need to enable JavaScript to run this app. 使用Python paho-mqtt对接broker无法收到预期消息如何解决
优惠活动
大模型
产品
解决方案
定价
更多

使用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格式消息,则需要再检查你本地代码的连接配置、主题订阅规则是否正确

补充说明

如果你期望的消息是推送到login的子主题下(如login/xxx),需要将订阅规则改为client.subscribe("login/#"),使用通配符匹配所有子主题的消息。

内容的提问来源于stack exchange,提问作者shantanu rahut

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 19:48:03