基于MQTT开发ESP32内置LED开关控制Arduino Sketch及连接问题排查
问题根因梳理
- 你之前通过MQTTBox验证了Broker可正常收发消息,说明Broker本身运行正常,所有异常都出在ESP32端的配置逻辑上
- 错误的Broker地址配置是核心诱因:
- 你在ESP32代码里填的
localhost,指代的是ESP32自身的环回地址(127.0.0.1),但MQTT Broker部署在运行Node-RED的电脑上,ESP32访问自己的1883端口完全无法触达Broker - 你尝试填写的“设备局域网IP”如果是ESP32自身的IP,和填localhost的逻辑错误一致;如果填写的是运行Node-RED的电脑的IP,也存在隐藏的配置坑
- 你在ESP32代码里填的
- 串口无输出的额外诱因:
- 串口监视器波特率和代码里
Serial.begin()的波特率不匹配 - 没有开启EspMQTTClient的调试日志,导致连接异常的信息没有打印
esp32_secrets.h的宏定义存在语法错误(比如字符串没加双引号),导致库初始化直接失败,卡在启动阶段
- 串口监视器波特率和代码里
- 容易遗漏的逻辑漏洞:
- 没有在
loop()函数中调用client.loop(),导致MQTT库无法正常处理连接和消息 - Node-RED所在电脑的防火墙拦截了1883端口的局域网入站请求
- 没有在
分步解决方案
先解决串口无输出的基础问题
- 核对代码里
Serial.begin()的波特率,必须和串口监视器右下角选择的波特率完全一致(ESP32通用配置为115200) - 打开EspMQTTClient的调试日志,在
setup()中添加client.enableDebuggingMessages(true),打印WiFi、MQTT连接的全流程日志,方便定位卡在哪一步 - 检查
esp32_secrets.h的语法正确性,参考以下标准格式编写:// esp32_secrets.h #ifndef ESP32_SECRETS_H #define ESP32_SECRETS_H // 所有配置项必须加双引号,为字符串类型 #define WIFI_SSID "你的WiFi名称" #define WIFI_PASSWORD "你的WiFi密码" #define BROKER_IP "运行Node-RED的电脑的局域网IP" // 例:"192.168.3.15" #endif - 确认Arduino IDE中选择的开发板型号、对应串口端口正确,避免选错端口导致无日志输出
- 核对代码里
修正MQTT Broker地址配置
- 绝对不要在ESP32的代码中使用
localhost,该地址永远指向ESP32自身 - 注意区分:Node-RED中MQTT输出模块填
localhost是可行的(因为Node-RED和Broker运行在同一台电脑),但ESP32作为外部设备,必须填写运行Broker的电脑的局域网IP,不能填ESP32自己的IP - 获取运行Node-RED的电脑的局域网IP:Windows系统执行
ipconfig查询对应网卡的IPv4地址,Linux/macOS执行ip a或ifconfig查询,确保该IP和ESP32连接的WiFi处于同一网段 - 临时关闭电脑的防火墙,或添加1883端口的入站允许规则,避免局域网设备的访问被拦截
- 绝对不要在ESP32的代码中使用
核对EspMQTTClient的完整初始化逻辑
参考以下可正常运行的代码结构排查是否有遗漏:#include <EspMQTTClient.h> #include "esp32_secrets.h" // 初始化MQTT客户端,参数顺序为WiFi名、WiFi密码、Broker IP、端口、客户端ID EspMQTTClient client( WIFI_SSID, WIFI_PASSWORD, BROKER_IP, 1883, "ESP32_LED_Controller" // 客户端ID不能和其他连入Broker的设备重复 ); const int LED_PIN = 2; // 连接Broker成功后的回调函数 void onConnectionEstablished() { client.subscribe("test1", [](const String &payload) { // 收到消息后控制LED电平 if (payload == "1") { digitalWrite(LED_PIN, HIGH); } else if (payload == "0") { digitalWrite(LED_PIN, LOW); } }); } void setup() { Serial.begin(115200); pinMode(LED_PIN, OUTPUT); client.enableDebuggingMessages(true); // 开启调试日志 } void loop() { client.loop(); // 必须循环调用,否则无法处理MQTT连接和消息 }额外排查项
- 确认ESP32连接的WiFi和运行Node-RED的电脑处于同一局域网,不要连接访客WiFi(多数访客WiFi会开启AP隔离,禁止设备之间互访)
- 检查MQTT Broker是否配置了用户名密码校验,如果开启了权限校验,需要在EspMQTTClient初始化时补充对应的用户名、密码参数
- 确认ESP32连入的WiFi网络没有开启AP隔离限制
内容的提问来源于stack exchange,提问作者Adamelli
相关产品推荐
相关产品推荐

