ESP32 Arduino作为TCP服务器的配置步骤

如何让 ESP32 变身 TCP 服务器：从零构建稳定可靠的局域网通信中枢

你有没有遇到过这样的场景？

手头的传感器数据想实时传到电脑上分析，但串口线太短、蓝牙配对麻烦；或者做了一个智能灯控系统，希望手机和电脑都能随时连接控制，又不想依赖云平台——延迟高还可能断连。

其实，

ESP32 本身就具备成为“通信中心”的能力

。只要把它配置成一个

TCP 服务器

，就能在局域网内提供一个稳定、低延迟、跨平台的通信接口。无需路由器转发、不用公网 IP，插电即用，任何设备只要在同一 Wi-Fi 下，就能通过标准 TCP 协议与它对话。

本文将带你一步步实现这个功能，不讲空话，只说实战要点。我们会深入

WiFiServer

和

WiFiClient

的工作机制，剖析常见坑点，并给出可直接复用的代码模板。读完后，你不仅能跑通示例，还能理解背后的设计逻辑，为后续扩展打下坚实基础。

为什么选 TCP 而不是 HTTP 或 MQTT？

在物联网开发中，通信协议的选择往往决定了系统的灵活性和性能表现。

• HTTP Server

  看似友好（毕竟浏览器就能测试），但它本质是“请求-响应”模式，客户端必须主动发起请求才能获取数据，不适合持续推送状态；

• MQTT

  适合大规模设备联网，但需要额外部署 Broker，增加了复杂性和故障点；

• 而原生 TCP

  ，就像一条双向对讲通道，连接建立后双方可以随时发消息，没有多余封装，延迟最低，资源占用最少。

对于局域网内的设备调试、远程控制、日志透传等场景，

TCP 是最轻量也最高效的解决方案

。尤其当你只需要几个客户端连接时，自己搭个 TCP 服务比接入整套云架构要快得多。

ESP32 基于 lwIP 协议栈实现了完整的 TCP/IP 支持，配合 Arduino 框架提供的

WiFiServer

类，几行代码就能启动监听。接下来我们就来看看它是怎么工作的。

核心角色：

WiFiServer

与

WiFiClient

WiFiServer

—— 守门人

你可以把

WiFiServer

想象成酒店前台。它的职责很简单：

创建方式非常直观：

WiFiServer server(3333); // 监听 3333 端口

一旦调用

server.begin()

，ESP32 就会在当前获得的局域网 IP 上开启监听。比如你的 ESP32 获取到的是

192.168.1.100

，那么其他设备就可以通过

192.168.1.100:3333

这个地址尝试连接。

⚠️

小贴士

：避免使用 80、443、21 等常用端口，除非你明确知道它们的用途。推荐使用 1024 以上的自定义端口，如 3333、8080、9000。

WiFiClient

—— 每个连接的独立会话

每个成功连接的客户端都会对应一个

WiFiClient

对象。它是真正的“通信载体”，所有收发操作都通过它完成。

关键方法包括：

作用

注意：

WiFiClient

是

流式传输

，不像 UDP 那样有明确报文边界。如果客户端连续发送

"HELLO"

和

"WORLD"

，你可能会一次性收到

"HELLOWORLD"

—— 这就是所谓的“粘包”问题。

解决办法也很简单：

约定分隔符

，比如每条命令以

\\n

结尾，接收时用

readStringUntil('\\n')

分割即可。

最简可用代码：先让它跑起来

下面是一段经过验证的基础版本，功能完整且易于调试：

#include <WiFi.h>

const char* ssid = "YOUR_WIFI_SSID";
const char* password = "YOUR_WIFI_PASSWORD";

WiFiServer server(3333);

void setup() {
Serial.begin(115200);

WiFi.begin(ssid, password);
Serial.print("Connecting to Wi-Fi");

while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print(".");
}

Serial.println();
Serial.print("Connected! IP: ");
Serial.println(WiFi.localIP());

server.begin(); // 开始监听
Serial.println("TCP Server running on port 3333");
}

void loop() {
WiFiClient client = server.available(); // 检查是否有新连接
if (client) {
Serial.println("New client connected");

while (client.connected()) {
if (client.available()) {
String msg = client.readStringUntil('\\n');
msg.trim(); // 去除前后空白字符
Serial.println("Received: " + msg);

// 回显处理结果
client.println("Echo: " + msg);
}
delay(10); // 给出处理余地，防止阻塞
}

Serial.println("Client disconnected");
client.stop(); // 显式关闭连接
}

delay(10);
}

烧录后打开串口监视器，你会看到类似输出：

Connected! IP: 192.168.1.100
TCP Server running on port 3333

此时，打开任意 TCP 工具（如 Windows 的 NetAssist、macOS 的 SocketTest、或 Python 脚本），输入 IP 和端口连接，发送文本并回车，即可看到 ESP32 的回应回传。

多客户端支持：别让第二个用户被拒之门外

默认情况下，上面的代码只能处理一个客户端。一旦有人连上，

server.available()

就不会再返回新的连接，直到当前会话断开。

这是因为

client

是局部变量，在

loop()

中被不断重新赋值。当多个客户端同时尝试连接时，后到的那个会被忽略。

要支持多客户端，必须

持久化保存每一个有效的

WiFiClient

实例

。常见做法是用数组管理：

#define MAX_CLIENTS 5
WiFiClient clients[MAX_CLIENTS];

void loop() {
// 检查是否有新连接请求
WiFiClient newClient = server.available();
if (newClient) {
// 寻找空槽位分配给新客户端
for (int i = 0; i < MAX_CLIENTS; i++) {
if (!clients[i].connected()) {
clients[i] = newClient;
Serial.printf("Client %d connected\\n", i);
break;
}
}
}

// 轮询所有已连接客户端
for (int i = 0; i < MAX_CLIENTS; i++) {
if (clients[i].connected()) {
if (clients[i].available()) {
String data = clients[i].readStringUntil('\\n');
data.trim();
Serial.printf("From Client %d: %s\\n", i, data.c_str());

// 示例：执行命令
if (data == "LED_ON") {
digitalWrite(LED_BUILTIN, HIGH);
clients[i].println("OK: LED ON");
} else if (data == "LED_OFF") {
digitalWrite(LED_BUILTIN, LOW);
clients[i].println("OK: LED OFF");
} else {
clients[i].println("ERROR: Unknown command");
}
}
} else {
// 清理已断开的连接
clients[i] = WiFiClient();
}
}

delay(10);
}

✅

提示

：记得在

setup()

中初始化引脚：

cpp
pinMode(LED_BUILTIN, OUTPUT);
digitalWrite(LED_BUILTIN, LOW);

这样最多可容纳 5 个客户端同时在线。虽然 ESP32 默认限制为 5 个 TCP 连接（受 FreeRTOS-TCP 和内存限制），但对于大多数本地应用已经足够。

实战技巧：避开那些让人抓狂的“坑”

🛑 坑一：客户端异常断开导致连接句柄卡死

有时候客户端程序崩溃或直接关闭网络，未正常发送 FIN 包，ESP32 会误以为连接仍在维持。这会导致该

WiFiClient

占据一个连接名额，无法释放。

解决方案

：加入心跳检测机制。

每隔一段时间向客户端发送一个小消息（如

PING\\n

），若多次无响应则强制断开：

unsigned long lastPing[5] = {0};

// 在轮询循环中添加
if (millis() – lastPing[i] > 30000) { // 每30秒ping一次
if (clients[i].connected()) {
clients[i].println("PING");
lastPing[i] = millis();
} else {
clients[i].stop();
}
}

客户端需回应

PONG

，否则视为离线。

📦 坑二：数据粘包/拆包

如前所述，TCP 是字节流，不能假设每次

available()

触发都能读到完整命令。

最佳实践

：

• 使用

  \\n

  或

  \\r\\n

  作为命令终止符；

• 使用

  readStringUntil()

  替代

  readString()

  ；

• 对关键命令增加长度校验或 CRC 校验。

例如：

if (client.available()) {
String cmd = client.readStringUntil('\\n');
if (cmd.length() > 0) { // 确保非空
cmd.trim();
processCommand(cmd, client);
}
}

💾 坑三：内存泄漏风险

不要在中断服务函数（ISR）中调用

client.print()

或进行字符串拼接操作。这些函数可能涉及动态内存分配（heap），而 ISR 中禁止使用堆操作，极易引发崩溃。

建议做法：在 ISR 中仅设置标志位，主循环中再处理网络通信。

典型应用场景：不只是回声测试

这套机制一旦掌握，便可快速搭建多种实用系统：

🔍 场景一：远程传感器监控

• 接入 DHT11、BH1750、MPU6050 等传感器；
• 客户端发送

  GET_TEMP

  、

  GET_LIGHT

  等指令；

• ESP32 返回 JSON 格式数据：

  {"temp":25.3,"humidity":60}

  ；

• PC 端用 Python 实时绘图，无需额外硬件。

💡 场景二：多路灯光控制系统

• 多个继电器模块受 GPIO 控制；
• 手机 App 发送

  RELAY1=ON

  、

  RELAY2=OFF

  ；

• ESP32 解析后驱动相应引脚；
• 回传当前状态，形成闭环控制。

🏭 场景三：工业设备状态看板

• 多台 ESP32 分别作为不同产线的 TCP 服务器；
• 中央主机定时轮询各设备 IP:端口；
• 收集运行状态、报警信息、产量统计；
• 构建简易 SCADA 局域网系统，成本极低。

性能边界与优化方向

虽然 ESP32 性能强大，但仍需注意以下限制：

当前能力

可优化方向

未来进阶思路：

• 添加 UDP 广播功能，实现设备自动发现（类似“查找局域网设备”）；
• 集成简单的 AT 指令集，打造通用调试接口；
• 结合 LittleFS 存储配置参数，实现断电记忆；
• 移植为组件库，供多个项目复用。

掌握了 ESP32 作为 TCP 服务器的技术，你就拥有了构建本地化智能系统的“钥匙”。它不依赖云端、响应迅速、兼容性强，特别适合原型验证、教学演示和小型商用产品。

更重要的是，这一过程让你真正理解了嵌入式网络的本质：

不是调用几个 API 就完事，而是要懂得连接管理、状态维护、异常处理的完整逻辑

。

如果你正在做一个需要远程交互的小项目，不妨试试这条路。也许你会发现，最简单的方案，往往是最可靠的。

你已经迈出了第一步——现在，去点亮那盏由 TCP 命令控制的灯吧。

如果有问题，欢迎留言讨论。