1. 问题背景ESP-01S 是 ESP8266 系列中最小巧、最便宜的一款 Wi-Fi 模块常用于物联网传感器节点、智能开关等低功耗场景。很多开发者在用 Arduino IDE 或 PlatformIO 烧录固件后会通过串口发送 JSON 格式的数据比如上报传感器数据或接收控制指令。但不少朋友会遇到一个棘手的问题烧录的固件在发送 JSON 格式语句时出现不兼容现象具体表现为接收端收到的 JSON 是乱码或截断的模块发送 JSON 后死机或重启串口监视器显示 JSON 内容包含多余的反斜杠或转义符JSON 解析失败提示格式错误。本文将从硬件特性、固件库、内存管理、JSON 构建方式等多个角度帮你彻底排查和解决 ESP-01S 发送 JSON 不兼容的问题。2. 为什么 ESP-01S 更容易出现 JSON 发送问题ESP-01S 的硬件资源非常有限相比 ESP32 或 NodeMCU 开发板它有以下短板Flash 容量小通常只有 1MB部分型号 512KB编译后的固件很容易超出空间。RAM 极小可用堆内存通常只有 4050KB动态分配 JSON 字符串时容易内存不足。引脚数量少只有 2 个可用 GPIO不能外接 PSRAM 扩展内存。串口只有一个UART0同时用于烧录、调试和对外通信容易产生数据冲突。这些限制导致在构建和发送 JSON 时如果使用不当很容易触发 watch dog 复位、内存碎片化或字符串截断。3. 常见原因一JSON 字符串构建不规范很多开发者习惯用sprintf或字符串拼接来手动生成 JSON比如char json[128]; sprintf(json, {\temp\:%.2f,\hum\:%.2f}, temperature, humidity);这种方式在 ESP-01S 上容易出问题JSON 中的双引号、反斜杠需要手动转义容易遗漏或写错。浮点数格式化可能因库版本不同而产生不一致的输出。如果 JSON 内容包含特殊字符如换行符、引号未转义会导致 JSON 格式错误。固定大小的缓冲区char json[128]很容易溢出导致内存越界重启。推荐方案使用成熟的 JSON 库如 ArduinoJson来构建它自动处理转义和内存管理并且针对 ESP8266 进行了优化。4. 常见原因二ArduinoJson 版本与内存模式不匹配ArduinoJson 6.x 和 7.x 默认使用动态内存分配但在 ESP-01S 这种内存紧张的场景下动态分配容易导致碎片化进而引发 JSON 序列化失败。ArduinoJson 提供了StaticJsonDocument静态内存和DynamicJsonDocument动态内存两种模式。使用StaticJsonDocument可以避免 heap 碎片但需要预先估计 JSON 大小。如果估算不足序列化时会报错或截断。示例#include ArduinoJson.h StaticJsonDocument200 doc; doc[device] ESP-01S; doc[temp] 25.6; doc[hum] 60.2; char buffer[256]; serializeJson(doc, buffer); Serial.println(buffer);如果 JSON 实际大小超过 200 字节serializeJson会返回 0并清空 buffer。此时可以通过测量实际 JSON 大小来调整StaticJsonDocument的容量或者使用DynamicJsonDocument并定期释放内存。5. 常见原因三串口发送时数据被截断或冲突ESP-01S 的 UART0 同时用于烧录和调试输出部分固件在启动时会打印 boot 信息这些信息可能混入 JSON 数据中。此外Serial.println默认添加回车换行而有些接收端如 Python 的json.loads对末尾换行敏感。解决办法在发送 JSON 前延迟一段时间等待串口稳定。使用Serial.print代替Serial.println避免多余换行。如果通过 Wi-Fi 发送 JSON如 MQTT 或 HTTP确保发送前字符串结尾有\0。检查串口波特率是否匹配ESP-01S 默认波特率 115200 或 74880接收端需一致。6. 常见原因四JSON 数据中包含二进制或非 UTF-8 字符如果 JSON 中直接包含从传感器读取的原始二进制数据或者包含非 UTF-8 字符如 GBK 编码的中文接收端可能解析失败。JSON 标准要求文本必须是 UTF-8 编码。解决方案将二进制数据转换为 Base64 或十六进制字符串再放入 JSON。确保所有字符串都是 UTF-8 编码必要时用iconv或 Arduino 的String转换为 UTF-8。7. 暴力解决 小白专用如果 JSON 的兼容性问题实在让你头疼还有一种更简单粗暴的方式——使用纯文本格式传输传感器数据。纯文本不需要任何 JSON 库不涉及转义、内存分配、编码等问题接收端解析也极其简单。比如用逗号分隔的键值对或者简单的 CSV 格式// 纯文本格式发送传感器数据完全避开 JSON 兼容性问题 void sendPlainText() { // 格式deviceESP-01S,temp25.6,hum60.2,ts12345 Serial.print(deviceESP-01S,); Serial.print(temp); Serial.print(temperature); Serial.print(,); Serial.print(hum); Serial.print(humidity); Serial.print(,); Serial.print(ts); Serial.println(millis()); }接收端如 Python解析也很方便# 接收端解析纯文本传感器数据 line serial_port.readline().decode().strip() data {} for pair in line.split(,): key, value pair.split(, 1) data[key] value print(data) # {device: ESP-01S, temp: 25.6, hum: 60.2, ts: 12345}这种方式的优点很明显零依赖不需要 ArduinoJson 等任何第三方库固件体积更小。零内存开销不需要为 JSON 文档预留缓冲区Serial.print直接逐段输出内存占用极小。无转义问题没有双引号、反斜杠等特殊字符不会出现格式错误。不会截断数据逐段发送不存在固定缓冲区溢出的问题。当然纯文本格式也有局限数据嵌套结构不友好、字段名会重复传输占用带宽。但对于传感器定时上报这类简单场景纯文本格式完全够用而且比 JSON 稳定得多。如果你的 ESP-01S 项目对 JSON 兼容性实在搞不定不妨试试这个方案很多工业物联网设备其实也还在用类似的纯文本协议。8. 实战编写一个稳定发送 JSON 的 ESP-01S 固件示例下面是一个完整的 Arduino 示例使用 ArduinoJson 7 和StaticJsonDocument通过串口定时发送温度和湿度 JSON 数据。#include ArduinoJson.h // 模拟传感器数据 float temperature 25.6; float humidity 60.2; void setup() { Serial.begin(115200); delay(2000); // 等待串口稳定 } void loop() { // 创建静态 JSON 文档容量根据实际 JSON 大小调整 StaticJsonDocument200 doc; // 填充数据 doc[device] ESP-01S; doc[temp] temperature; doc[hum] humidity; doc[timestamp] millis(); // 序列化为字符串 char buffer[256]; size_t len serializeJson(doc, buffer); if (len 0) { // 成功发送 JSON Serial.println(buffer); } else { // 容量不足输出错误提示 Serial.println({\error\:\JSON buffer overflow\}); } delay(5000); // 每 5 秒发送一次 }测试时打开串口监视器设置波特率 115200应能看到类似以下输出{device:ESP-01S,temp:25.6,hum:60.2,timestamp:12345}如果 JSON 一直输出错误提示说明StaticJsonDocument容量太小可以适当增大数值或者改用DynamicJsonDocument并检查剩余内存。9. 总结ESP-01S 发送 JSON 不兼容的根源通常在于手动拼接 JSON 字符串时转义错误或缓冲区溢出ArduinoJson 库容量设置不当导致序列化失败串口数据冲突或多余换行内存不足导致意外重启非 UTF-8 字符或二进制数据未处理。攻克这些细节后ESP-01S 同样可以稳定、高效地发送 JSON 数据。希望本文能帮助你快速定位问题让你的物联网项目更加可靠。