侧边栏壁纸
  • 累计撰写 93 篇文章
  • 累计收到 2 条评论

ESP32刷MicroPython对接阿里云MQTT的踩坑记录

2026-11-19 / 0 评论 / 1 阅读

ESP32刷MicroPython对接阿里云MQTT的踩坑记录

前几天翻抽屉找出来吃灰快半年的ESP32开发板,想刷个MicroPython做温湿度节点连阿里云物联网平台,结果刚写好MQTT连接代码就卡了壳,踩的坑攒了小半页笔记,整理出来给同样在折腾的朋友参考。

一开始连不上的诡异状态

当时用Thonny刷了最新稳定版的MicroPython固件,先写了WiFi连接测试代码,串口能正常打印拿到的局域网IP,ping外网地址也能通,但是一运行MQTT连接的逻辑,要么卡个十几秒直接抛连接重置的错误,要么刚建立连接就被服务端踢断,串口除了错误码没有任何额外提示。

绕了好多弯路的排查过程

一开始完全摸不着头绪,绕了好多没必要的弯路:

  • 以为是阿里云控制台的三元组抄错了,来回复制粘贴了三四遍,逐字核对甚至把引号前后的空格都删干净了,还是连不上。
  • 怀疑是端口或者网络拦截问题,先后试了MQTT常用的几个端口,又在电脑上用MQTT.fx客户端拿同样的参数测试,结果一点就通,说明云端配置和网络本身都没问题。
  • 甚至去查了路由器是不是开了AP隔离、禁了设备外网权限,换手机热点给ESP32连,故障还是一模一样。

后来翻umqtt.simple的官方文档才反应过来,两个小问题叠在一起导致的:一是我照着旧教程拼的客户端参数格式不对,阿里云现在的MQTT接入对clientId、用户名、签名格式有严格要求;二是umqtt库默认用的是MQTT 3.1协议,阿里云现在的接入点只支持3.1.1版本,协议不匹配的时候服务端直接断连,不会回任何错误提示,所以串口才只打一个模糊的连接重置错误。

调通后的正确配置步骤

  1. 先确保你刷的MicroPython固件版本在1.19以上,太老的版本umqtt库的协议版本参数有bug,设了也不生效,直接用Thonny的固件烧录工具选最新稳定版刷就行。
  2. 按照阿里云的规则拼接三个MQTT认证参数,不要自己随便填:
    • clientId:自定义设备标识符(随便起,比如esp32_01),后面拼接固定后缀<|securemode=3,signmethod=hmacsha1|>,如果用SSL加密的8883端口,把securemode的值改成2。
    • userName:格式是「设备名&产品Key」,中间的&符号不能少。
    • passWord:用DeviceSecret当密钥,对固定顺序的拼接字符串做HMAC-SHA1加密,结果转十六进制小写,拼接顺序错一个字符签名验证都过不了。
  3. 初始化MQTTClient的时候,一定要加proto=4这个参数,这个参数对应MQTT 3.1.1版本,不写的话默认是3,连不上阿里云的接入点。

可以直接参考下面的测试代码,替换成自己的三元组和WiFi信息就能用:

from umqtt.simple import MQTTClient
import ubinascii
import hmac, hashlib
import network
import time

# 替换成你自己的阿里云三元组和区域
PRODUCT_KEY = "替换成你的ProductKey"
DEVICE_NAME = "替换成你的DeviceName"
DEVICE_SECRET = "替换成你的DeviceSecret"
REGION_ID = "cn-shanghai"

# WiFi配置
WIFI_SSID = "你的WiFi名称"
WIFI_PWD = "你的WiFi密码"

# 拼接MQTT认证参数
CLIENT_ID = "esp32_01|securemode=3,signmethod=hmacsha1|"
USER_NAME = DEVICE_NAME + "&" + PRODUCT_KEY
# 生成签名,注意拼接顺序不能乱
sign_content = "clientIdesp32_01deviceName{}productKey{}".format(DEVICE_NAME, PRODUCT_KEY)
sign = hmac.new(DEVICE_SECRET.encode(), sign_content.encode(), hashlib.sha1).hexdigest()
MQTT_SERVER = "{}.iot-as-mqtt.{}.aliyuncs.com".format(PRODUCT_KEY, REGION_ID)
MQTT_PORT = 1883

# 连接WiFi
wlan = network.WLAN(network.STA_IF)
wlan.active(True)
wlan.connect(WIFI_SSID, WIFI_PWD)
while not wlan.isconnected():
    time.sleep(1)
print("WiFi连接成功,IP:", wlan.ifconfig()[0])

# 关键参数proto=4对应MQTT 3.1.1
client = MQTTClient(CLIENT_ID, MQTT_SERVER, MQTT_PORT, USER_NAME, sign, keepalive=60, ssl=False, proto=4)
client.connect()
print("MQTT连接成功")
几个容易被忽略的细节:
  • 如果要走8883的SSL加密连接,记得提前把ssl参数设为True,并且在固件里导入阿里云的根证书,调试阶段建议先用1883的非加密端口,少走点弯路。
  • 签名的待拼接字符串里不要随便加空格、换行,我之前就是在deviceName前面多打了个下划线,卡了好久。
  • keepalive参数不要设得太小,设60秒左右就行,设成个位数的话可能刚连上就被服务端判定为异常踢下线。

反正我现在写物联网设备MQTT连接代码,第一反应先确认协议版本参数,再也不想对着没有任何提示的断连日志瞎猜问题了。

评论一下?

OωO
取消