ESP32 WebSocket/SocketIO经NGINX+SSL连接Node-RED故障排查

核心问题分析 #

从现象看，网页客户端正常但ESP32频繁断开，结合报错errno: 11（对应Linux EAGAIN，即资源暂时不可用），问题集中在ESP32的网络客户端处理逻辑和SSL/TLS连接适配上，Nginx配置本身无明显问题（已适配WebSocket/SocketIO）。

分步排查与修复 #

1. 修复SSL/TLS连接问题（端口443报错400的根源） #

ESP32使用普通WiFiClient连接443端口时，无法处理SSL握手，导致服务器返回400错误。必须改用WiFiClientSecure：

#include <WiFiClientSecure.h>

WiFiClientSecure client;

void setup() {
  // 测试阶段可跳过证书验证（生产环境需配置服务器证书）
  client.setInsecure();
  
  // SocketIO连接：无需手动加EIO参数，库会自动处理
  webSocket.beginSocketIO("path.to.server", 443, "/socket.io");
  // 若用原生WebSocket：
  // webSocket.begin("path.to.server", 443, "/ws/path");
  
  webSocket.onEvent(webSocketEvent);
  webSocket.setReconnectInterval(5000);
}

2. 修正SocketIO路径参数冗余问题 #

原代码中beginSocketIO的路径写了"/socket.io/?EIO=4"，手动添加的EIO=4会与库自动生成的参数冲突，导致服务器响应解析失败。直接简化为"/socket.io"即可。

3. 解决flush()失败的资源问题 #

报错flush(): fail on fd 48, errno: 11是ESP32 WiFi客户端缓冲区满或网络暂时阻塞导致的，可通过以下方式缓解：

• 升级库版本：确保使用最新版Links2004/arduinoWebSockets，旧版本对ESP32的WiFiClient兼容性较差；
• 调整缓冲区大小：在初始化WiFiClientSecure后增加缓冲区设置：

  client.setBufferSize(1024); // 增大缓冲区至1KB，默认可能较小
  

• 增加循环延迟：在loop()中webSocket.loop()前添加短延迟，避免高频操作耗尽资源：

  void loop() {
    delay(10);
    webSocket.loop();
  }
  

4. 优化Nginx配置（可选，增强兼容性） #

虽然网页客户端正常，但可给Nginx添加X-Forwarded-Proto头，让Node-RED识别原请求协议：
在location /的proxy_set_header块中添加：

proxy_set_header X-Forwarded-Proto $scheme;

5. 排除硬件与环境干扰 #

• 检查ESP32的WiFi信号强度（Serial.println(WiFi.RSSI())），信号过弱会导致频繁断连；
• 测试时关闭ESP32的其他网络任务，避免资源竞争。

验证步骤 #

1. 先测试原生WebSocket连接（用webSocket.begin()），确认连接稳定后再切换到SocketIO；
2. 查看Node-RED的日志，确认ESP32的连接请求被正确接收且无异常断开；
3. 若仍有问题，开启库的调试日志（webSocket.enableDebug(true)），输出更详细的交互过程定位问题。

内容的提问来源于stack exchange，提问作者Jean-Philippe Encausse