在 ESP32 开发中，使用 TCP 发送数据时可能遇到的常见错误码及其说明如下：

常见 TCP 发送错误码（send 函数返回）

1. ESP_ERR_NO_MEM (-0x0011)

   • 含义：内存不足，无法分配发送缓冲区。
   • 原因：系统内存耗尽或发送缓冲区过小。
   • 解决：优化内存使用，增大 CONFIG_LWIP_TCP_SND_BUF（发送缓冲区大小）。

2. EAGAIN / EWOULDBLOCK (-0x000C)

   • 含义：非阻塞模式下，发送缓冲区已满，需等待可写。
   • 原因：数据未及时发送，或网络拥堵。
   • 解决：重试发送，或使用 select()/poll() 监听可写事件。

3. ENOTCONN (-0x0009)

   • 含义：TCP 连接未建立或已断开。
   • 原因：未调用 connect() 成功，或对端关闭了连接。
   • 解决：检查连接状态，重新建立连接。

4. ECONNRESET (-0x000B)

   • 含义：连接被对端强制重置。
   • 原因：对端异常关闭（如进程崩溃、主动发送 RST）。
   • 解决：重新建立连接，并处理异常断开逻辑。

5. EINVAL (-0x0004)

   • 含义：参数无效（如 socket 句柄错误或数据指针为空）。
   • 解决：检查 socket 是否有效，确认发送数据指针合法性。

6. ETIMEDOUT (-0x0006)

   • 含义：连接超时（如长时间无响应）。
   • 原因：网络中断或对端无响应。
   • 解决：检查网络状态，增加超时阈值或重试机制。

调试建议

• 检查连接状态：确保 send() 前已完成 TCP 握手。
• 错误处理：在循环中处理 EAGAIN，避免数据丢失。
• 日志记录：使用 esp_log 打印错误码和上下文信息。
• 内存优化：监控内存使用，调整 FreeRTOS 堆大小或 lwIP 缓冲区配置。
• 网络工具：用 ping、netstat 或 Wireshark 分析网络行为。

参考

• ESP-IDF 文档：TCP API 错误码
• lwIP 手册：底层 TCP/IP 协议栈的错误码定义。

遇到具体错误时，建议结合代码逻辑和网络状态综合分析。