Go / 系统课时
选对文本还是二进制协议
选对文本还是二进制协议
协议格式的选择会长期影响调试效率、网络成本和兼容方式。与其先问“哪种更快”,不如先确认通信双方、带宽预算、演进频率和排障环境,再决定文本协议还是二进制协议。本节给出一套可直接用于服务设计的判断顺序。
学习目标
- 从可读性、带宽、兼容性和实现复杂度四个维度比较文本与二进制协议
- 识别“体积更小”与“整体成本更低”之间的差异
- 根据系统边界和演进方式选择更稳妥的消息格式
先按约束而不是偏好做选择
文本协议把字段和值编码成可直接阅读的字符,典型代表是 JSON。它的优势是抓包、日志和临时调试都直观,跨语言接入门槛也低,但字段名、数字文本和分隔符会带来额外体积与解析成本。
二进制协议把数据编码成紧凑字节序列,例如 Protocol Buffers、MessagePack 或 CBOR。它通常能减少网络体积,并提供更明确的类型表达,但调试时往往需要 schema、解码工具或库支持,团队必须额外管理版本与生成代码。
四个维度怎么权衡
| 维度 | 文本协议 | 二进制协议 | 更偏向哪边 |
|---|---|---|---|
| 可读性 | 人和通用工具可直接查看 | 通常需要解码工具 | 经常抓包、联调时偏文本 |
| 带宽 | 字段名和文本数字有额外开销 | 通常更紧凑 | 高频小包、移动网络时偏二进制 |
| 兼容性 | 新旧字段容易观察,但约束靠约定或 schema | 常由明确 schema 和字段编号管理 | 长期演进时看版本规则是否成熟 |
| 实现复杂度 | 接入简单,动态语言尤其方便 | 需要编解码库、schema 或代码生成 | 团队规模小、接口变化快时偏文本 |
不要把表中的“通常”理解成绝对结论。一个设计良好的 JSON 消息可能比字段冗余的自定义二进制格式更稳定;压缩后的文本消息也可能显著缩小体积。真正要比较的是端到端成本,而不是只比较裸字节数。
兼容性往往比体积更关键
协议一旦上线,最难修改的通常不是编码函数,而是已经分布在客户端、服务端和历史数据中的字段语义。无论文本还是二进制,都应先定义字段是否可选、缺失时的默认含义、未知字段如何处理,以及旧版本遇到新消息时应做什么。
如果通信双方独立发布,建议显式保留版本演进空间,例如新增字段时保持旧字段含义不变,避免复用已经下线的字段标识。二进制协议若依赖 schema,还要把 schema 版本纳入构建和发布流程;文本协议也不代表“无需 schema”,只是约束可能写在文档或验证层里。
用一个决策顺序落地
- 先看边界:面向公开 API、人工联调或多团队接入时,优先考虑可读性和通用工具支持。
- 再看成本:消息频率高、带宽敏感、序列化占用明显时,再测量二进制编码能节省多少 CPU 和流量。
- 再看演进:如果客户端版本长期并存,优先选择有成熟兼容规则的格式,而不是只追求当前最小包体。
- 最后做基准:用真实消息分布比较编码后大小、编码与解码耗时、内存分配和排障成本,再决定是否切换。
一个常见结果是:外部 HTTP API 使用 JSON,便于接入与排障;内部高频 RPC 使用带 schema 的二进制协议,降低传输和解析成本。它们并不冲突,因为不同系统边界本来就可以采用不同协议。
什么时候不要急着换成二进制
如果当前瓶颈来自数据库、锁竞争或下游延迟,把 JSON 换成二进制通常不会改变端到端耗时。先用性能数据确认序列化或网络已经进入主要成本,再承担协议迁移和兼容治理的复杂度。
协议选择最终是在“人能否轻松理解”和“机器能否高效处理”之间做工程权衡。优先满足系统边界与演进需求,再用测量结果决定是否为性能支付额外复杂度。