ESP8266使用PubSubClient连接MQTT broker频繁新建断开连接问题咨询

• 端口配置不匹配：mosquitto日志显示MQTT服务监听端口为1884，但代码中client.setServer(mqtt_server, 1883)指定的连接端口为1883，端口不一致会导致连接建联异常。
• 代码存在语法错误：贴出的代码存在注释换行导致的语法问题，注释拆分后剩余的is the voltage level、as an output为无声明的独立语句，会触发编译或运行时异常，导致设备反复重启、重连MQTT：

  // 错误写法
  digitalWrite(BUILTIN_LED, LOW); // Turn the LED on (Note that LOW 
  is the voltage level
  
  pinMode(BUILTIN_LED, OUTPUT); // Initialize the BUILTIN_LED pin 
  as an output
  

• WiFi连接不稳定：若节点距离WiFi路由器过远、信号干扰大，会导致WiFi频繁重连，进而触发MQTT连接反复重建。
• PubSubClient默认参数限制：PubSubClient库默认的MQTT keepalive时间为15秒，且默认接收缓冲区仅256字节，如果broker推送的消息超过缓冲区大小，会直接触发连接断开。
• MQTT broker限流：代码每次重连都会生成随机的客户端ID，若broker侧配置了单IP最大连接数限制，大量短连接会触发限流，导致新连接被主动断开。

1. 修正端口配置：将代码中的MQTT端口改为实际mosquitto服务监听的1884端口：

   client.setServer(mqtt_server, 1884);
   

2. 修正代码语法错误：调整注释位置，避免代码被拆分：

   // Turn the LED on (Note that LOW is the voltage level, but actually the LED is on; this is because it is active low on the ESP-01)
   digitalWrite(BUILTIN_LED, LOW); 
   
   // Initialize the BUILTIN_LED pin as an output
   pinMode(BUILTIN_LED, OUTPUT); 
   

3. 排查WiFi稳定性：在loop函数中添加WiFi状态打印，确认是否存在WiFi频繁断开的情况，优先排查信号、信道干扰问题。
4. 调整PubSubClient参数：增大缓冲区和keepalive时间，适配业务场景：

   // 初始化后调整缓冲区大小为512字节，可根据实际消息大小调整
   client.setBufferSize(512);
   // 连接时指定30秒keepalive时间，替换原有的client.connect调用
   client.connect(clientId.c_str(), NULL, NULL, NULL, 0, false, NULL, false, 30);
   

5. 固定客户端ID（可选）：如果不需要动态clientid，可使用固定值，避免频繁生成新连接触发broker限流：

   // 替换原有随机clientid生成逻辑
   const char* clientId = "ESP8266Client-fixed";
   

6. 精准定位错误：在reconnect函数中打印client.state()的返回值，根据返回值定位具体错误：

   返回值	错误含义
   -4	连接超时
   -3	连接丢失
   -2	连接失败
   -1	断开连接
   0	连接成功
   1	无效的协议版本
   2	无效的客户端ID
   3	服务不可用
   4	用户名或密码错误
   5	未授权

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