NodeMCU ESP8266随机断开MQTT broker但WiFi连接正常问题求助

代码优化调整 #

• 固定MQTT客户端ID，避免随机ID冲突或生成异常：将reconnect函数内的随机ID逻辑替换为固定的唯一ID，两个模块分别设置不同值，示例如下：

// 出问题的模块设置为该值，正常模块设置为"ESP8266Client-02"即可
const char* clientId = "ESP8266Client-01";
// 连接时直接用clientId即可，不需要随机生成
if (client.connect(clientId)) {
  // 原有连接后逻辑
}

• 显式设置MQTT心跳时间，PubSubClient默认心跳为15秒，硬件晶振偏差可能导致心跳超时被broker主动踢下线，在client.setServer后添加配置：

client.setKeepAlive(30);

• 回调函数内不要直接执行MQTT发布操作，避免阻塞客户端心跳逻辑：将回调内的状态发布改为用全局标志位触发，在loop内执行发布逻辑，修改示例：

// 新增全局标志位
int publishState = -1;

void callback(char* topic, byte* payload, unsigned int length) {
  // 原有消息解析逻辑不变，替换掉原有的client.publish部分
  if ((char)payload[0] == '1') {
    digitalWrite(14, LOW); 
    publishState = 1;
  } else {
    digitalWrite(14, HIGH);
    publishState = 0;
  }
}

void loop() {
  if (!client.connected()) {
    reconnect();
  }
  client.loop();
  // 新增状态发布逻辑
  if(publishState != -1){
    client.publish("estado", String(publishState).c_str());
    publishState = -1;
  }
}

交叉验证排除硬件故障 #

• 互换两个模块的固件：将正常模块的固件刷入故障模块，故障模块的固件刷入正常模块，若故障跟随模块转移，判定为硬件问题；若故障跟随固件转移，判定为软件配置问题
• 供电排查：测量故障模块的3.3V引脚供电纹波，模块发射WiFi信号、执行MQTT操作时电压掉载超过0.2V的，判定为模块电源电路损坏
• Flash坏块检测：擦除故障模块全片Flash后重新烧录固件，若故障消失则为原有Flash坏块导致运行异常

Broker侧验证 #

查看MQTT服务端的连接日志，确认故障模块断开时的触发原因：

• 若为客户端心跳超时，对应优化心跳配置即可
• 若为服务端主动踢除连接，检查broker是否有单IP连接数、消息发布频率限制

内容的提问来源于stack exchange，提问作者sergio jauregui