1. 环境准备与基础概念
在开始ESP32作为TCP客户端与PC通信的实战之前，我们需要先准备好开发环境，并理解几个关键概念。ESP32是一款功能强大的Wi-Fi/蓝牙双模芯片，内置TCP/IP协议栈，非常适合物联网应用开发。
首先，你需要准备以下硬件和软件：
- ESP32开发板（如ESP32-WROOM-32）
- 安装了ESP-IDF开发环境的PC（推荐使用VSCode+PlatformIO插件）
- 网络调试工具（如NetAssist或SocketTool）
- 确保PC和ESP32连接到同一个局域网
关于TCP通信的基础原理，可以想象成打电话的过程。当ESP32作为客户端时，它需要知道服务端的"电话号码"（IP地址）和"分机号"（端口号）。建立连接后，双方就可以通过"说话"（send）和"听"（recv）来交换数据。
这里有个新手容易踩的坑：很多开发者会混淆客户端和服务端的角色。记住，在这个场景中：
- PC端运行的是TCP服务端程序（比如用Python写的socket服务器）
- ESP32是主动发起连接的客户端
- 两者必须在同一个网络环境下
2. ESP32客户端代码解析
让我们来看一个完整的ESP32 TCP客户端实现。这段代码基于ESP-IDF框架，我已经在实际项目中多次验证过其稳定性。
#include <string.h> #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "esp_wifi.h" #include "esp_event.h" #include "esp_log.h" #include "lwip/sockets.h" #define HOST_IP_ADDR "192.168.1.100" // 替换为你的PC IP #define PORT 8080 #define TAG "TCP_CLIENT" void tcp_client_task(void *pvParameters) { char rx_buffer[128]; while(1) { struct sockaddr_in dest_addr; dest_addr.sin_addr.s_addr = inet_addr(HOST_IP_ADDR); dest_addr.sin_family = AF_INET; dest_addr.sin_port = htons(PORT); int sock = socket(AF_INET, SOCK_STREAM, IPPROTO_IP); if (sock < 0) { ESP_LOGE(TAG, "创建socket失败: %d", errno); vTaskDelay(1000 / portTICK_PERIOD_MS); continue; } ESP_LOGI(TAG, "正在连接服务器 %s:%d...", HOST_IP_ADDR, PORT); int err = connect(sock, (struct sockaddr *)&dest_addr, sizeof(dest_addr)); if (err != 0) { ESP_LOGE(TAG, "连接失败: %d", errno); close(sock); vTaskDelay(3000 / portTICK_PERIOD_MS); continue; } ESP_LOGI(TAG, "连接成功!"); const char *message = "Hello from ESP32"; send(sock, message, strlen(message), 0); while(1) { int len = recv(sock, rx_buffer, sizeof(rx_buffer)-1, 0); if(len < 0) { ESP_LOGE(TAG, "接收错误: %d", errno); break; } else if(len == 0) { ESP_LOGW(TAG, "连接关闭"); break; } else { rx_buffer[len] = '\0'; ESP_LOGI(TAG, "收到 %d 字节: %s", len, rx_buffer); // 简单回显 send(sock, rx_buffer, len, 0); } } shutdown(sock, 0); close(sock); vTaskDelay(1000 / portTICK_PERIOD_MS); } vTaskDelete(NULL); }这段代码的关键点在于：
- 创建socket时指定了AF_INET（IPv4）和SOCK_STREAM（TCP）
- connect()会阻塞直到连接成功或超时
- send()和recv()是数据传输的核心函数
- 错误处理很重要，特别是对errno的判断
我在实际项目中遇到过连接不稳定的情况，后来发现是因为没有正确处理断开重连。现在的代码加入了循环重试机制，即使网络波动也能自动恢复连接。
3. PC端服务端实现
为了让ESP32客户端有可以通信的对象，我们需要在PC上搭建一个简单的TCP服务端。这里我用Python实现，因为它简单直观：
import socket HOST = '0.0.0.0' # 监听所有网络接口 PORT = 8080 with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s: s.bind((HOST, PORT)) s.listen() print(f"服务端启动，监听 {PORT} 端口...") conn, addr = s.accept() with conn: print(f"客户端已连接: {addr}") while True: data = conn.recv(1024) if not data: break print(f"收到数据: {data.decode()}") conn.sendall(data) # 回显数据这个服务端做了三件事：
- 绑定到指定端口开始监听
- 接受客户端连接
- 接收数据并原样返回（回显）
在实际测试时，我建议先用这个Python服务端验证基本通信，然后再开发更复杂的功能。记得在运行前关闭防火墙或开放对应端口，这是新手常遇到的"连接不上"问题的根源。
4. 常见问题与调试技巧
在开发ESP32 TCP客户端时，我踩过不少坑，这里分享几个典型问题和解决方法：
问题1：连接总是失败，errno=113这通常意味着ESP32和PC不在同一个网络。检查：
- PC和ESP32是否连接同一个路由器
- PC的防火墙是否阻止了连接
- IP地址是否正确（cmd中ipconfig查看）
问题2：数据收发不全TCP是流式协议，没有消息边界。建议：
- 在消息头添加长度字段
- 使用特定分隔符（如\n）
- 实现简单的协议，比如：
// 发送 char msg[128]; int len = sprintf(msg, "%04d%s", strlen(data), data); send(sock, msg, len, 0); // 接收 // 先读4字节获取长度，再读取指定长度的数据问题3：长时间运行后断开这是TCP的keepalive问题，解决方法：
int keepAlive = 1; int keepIdle = 5; int keepInterval = 5; int keepCount = 3; setsockopt(sock, SOL_SOCKET, SO_KEEPALIVE, &keepAlive, sizeof(keepAlive)); setsockopt(sock, IPPROTO_TCP, TCP_KEEPIDLE, &keepIdle, sizeof(keepIdle)); setsockopt(sock, IPPROTO_TCP, TCP_KEEPINTVL, &keepInterval, sizeof(keepInterval)); setsockopt(sock, IPPROTO_TCP, TCP_KEEPCNT, &keepCount, sizeof(keepCount));调试时建议：
- 在ESP-IDF中开启详细日志
esp_log_level_set("*", ESP_LOG_VERBOSE);- 使用Wireshark抓包分析
- 先确保基础通信正常，再添加业务逻辑
5. 性能优化与高级用法
当基础通信功能实现后，可以考虑以下优化：
多任务处理在FreeRTOS中创建专门的任务处理TCP通信：
xTaskCreate(tcp_client_task, "tcp_client", 4096, NULL, 5, NULL);数据缓冲区管理避免频繁分配内存，使用环形缓冲区：
typedef struct { uint8_t *buffer; size_t head; size_t tail; size_t size; } ring_buffer_t;SSL/TLS加密对于敏感数据，添加加密层：
#include "esp_tls.h" esp_tls_cfg_t cfg = { .cacert_pem_buf = (const unsigned char *)server_cert_pem_start, .cacert_pem_bytes = server_cert_pem_end - server_cert_pem_start }; esp_tls_t *tls = esp_tls_conn_new(host, strlen(host), port, &cfg);心跳机制定期发送心跳包检测连接状态：
void heartbeat_task(void *pvParameters) { while(1) { if(sock_connected) { send(sock, "PING", 4, 0); } vTaskDelay(5000 / portTICK_PERIOD_MS); } }在实际项目中，我建议将TCP通信模块化，封装成独立的组件，通过队列与其他任务交互。这样既提高了代码复用性，也便于维护和调试。
