4、应用层协议设计：JSON/Protobuf 在嵌入式中的取舍与实现

应用层协议，说白了就是设备之间“说人话”的规则。在嵌入式系统里，我们经常要在 JSON 和 Protobuf 之间做选择。这不是一个简单的“谁更好”的问题，而是“谁更适合你的场景”。

我早年做过一个智能网关项目，一开始图省事全用了 JSON，结果到了后期，内存和带宽双双告急。后来换成了 Protobuf，虽然开发时多花了点功夫，但产品稳定多了。今天我就把这段经验拆开来讲。

4.1 两种协议的底层差异

先看一张对比表，把核心差异说清楚：

为什么会这样？JSON 的每个键名都要重复传输，比如 "temperature": 25.3 这串字符，光键名就占了十几个字节。而 Protobuf 用字段编号代替键名，比如字段 1 代表 temperature，传输时只写 0x08 0xCB 0x01 三个字节。你想想看，在 115200 波特率的串口上，这个差距有多明显。

4.2 什么时候选 JSON？

我个人习惯把 JSON 用在三个场景：

• 调试阶段：开发初期，协议还没定型，JSON 改起来最快。我经常在串口助手里直接改 JSON 字符串测试，不用重新编译固件。
• 配置管理：设备启动时读取的配置文件，比如 WiFi 密码、服务器地址。这些数据量小，变化频繁，JSON 的灵活性正好派上用场。
• 与云端交互：如果对接的是 RESTful API，JSON 是事实标准。强行用 Protobuf 反而增加网关转换的复杂度。

4.3 什么时候必须上 Protobuf？

反过来，Protobuf 也有它不可替代的地方：

• 高频率数据上报：比如传感器每秒上报 100 次数据。用 JSON 的话，光序列化就能吃掉 30% 的 CPU。
• 低带宽链路：LoRa、NB-IoT 这类窄带通信，每字节都珍贵。Protobuf 能把 200 字节的 JSON 压缩到 30 字节。
• 多平台互操作：如果你的系统涉及 C、Java、Python 等多种语言，Protobuf 的代码生成器能自动生成各语言的数据结构，省去手写解析器的麻烦。

4.4 嵌入式中的 Protobuf 实现要点

如果你决定用 Protobuf，有几点要注意：

1. 使用 Nanopb：Google 官方的 protobuf-c 对 MCU 来说太重了。Nanopb 是专为嵌入式优化的版本，生成的代码体积小，支持静态内存分配。
2. 避免动态消息：在 .proto 文件中尽量少用 repeated 和 map 类型，它们会引入动态内存分配。用固定长度的数组代替。
3. 预计算最大尺寸：用 Nanopb 的 pb_encode 前，先调用 pb_get_encoded_size 算出最大缓冲区需求，避免溢出。

下面是一个典型的 Nanopb 编码示例：

// sensor.proto
message SensorData {
    required uint32 id = 1;
    required float temperature = 2;
    required float humidity = 3;
    optional uint32 battery = 4 [default = 100];
}

// 编码端代码
#include <pb_encode.h>
#include "sensor.pb.h"

uint8_t buffer[64];
SensorData data = {
    .id = 1,
    .temperature = 25.3,
    .humidity = 60.5,
    .battery = 85
};

pb_ostream_t stream = pb_ostream_from_buffer(buffer, sizeof(buffer));
if (!pb_encode(&stream, SensorData_fields, &data)) {
    // 编码失败处理
}
// stream.bytes_written 就是实际编码长度

4.5 混合使用策略

在实际产品中，我很少只用一种协议。更常见的做法是：

• 控制通道用 JSON：用于设备发现、参数查询、调试指令。这些交互频率低，但需要人类可读。
• 数据通道用 Protobuf：用于传感器数据、状态上报、日志批量传输。这些数据量大，对效率要求高。

这样做的好处是，调试时用 JSON 通道直接看设备状态，生产运行时用 Protobuf 通道保证性能。两个通道互不干扰。

4.6 知识体系图

下面这张图总结了本章的核心决策逻辑：

4.7 性能实测数据

最后给一组我在 STM32F407 上实测的数据，供你参考：

嗯，数据摆在这里，怎么选你应该心里有数了。记住：没有银弹，只有最适合你当前场景的方案。