Go / 系统课时

选对文本还是二进制协议

选对文本还是二进制协议

协议格式的选择会长期影响调试效率、网络成本和兼容方式。与其先问“哪种更快”,不如先确认通信双方、带宽预算、演进频率和排障环境,再决定文本协议还是二进制协议。本节给出一套可直接用于服务设计的判断顺序。

学习目标

  • 从可读性、带宽、兼容性和实现复杂度四个维度比较文本与二进制协议
  • 识别“体积更小”与“整体成本更低”之间的差异
  • 根据系统边界和演进方式选择更稳妥的消息格式

先按约束而不是偏好做选择

文本协议把字段和值编码成可直接阅读的字符,典型代表是 JSON。它的优势是抓包、日志和临时调试都直观,跨语言接入门槛也低,但字段名、数字文本和分隔符会带来额外体积与解析成本。

二进制协议把数据编码成紧凑字节序列,例如 Protocol Buffers、MessagePack 或 CBOR。它通常能减少网络体积,并提供更明确的类型表达,但调试时往往需要 schema、解码工具或库支持,团队必须额外管理版本与生成代码。

四个维度怎么权衡

维度 文本协议 二进制协议 更偏向哪边
可读性 人和通用工具可直接查看 通常需要解码工具 经常抓包、联调时偏文本
带宽 字段名和文本数字有额外开销 通常更紧凑 高频小包、移动网络时偏二进制
兼容性 新旧字段容易观察,但约束靠约定或 schema 常由明确 schema 和字段编号管理 长期演进时看版本规则是否成熟
实现复杂度 接入简单,动态语言尤其方便 需要编解码库、schema 或代码生成 团队规模小、接口变化快时偏文本

不要把表中的“通常”理解成绝对结论。一个设计良好的 JSON 消息可能比字段冗余的自定义二进制格式更稳定;压缩后的文本消息也可能显著缩小体积。真正要比较的是端到端成本,而不是只比较裸字节数。

兼容性往往比体积更关键

协议一旦上线,最难修改的通常不是编码函数,而是已经分布在客户端、服务端和历史数据中的字段语义。无论文本还是二进制,都应先定义字段是否可选、缺失时的默认含义、未知字段如何处理,以及旧版本遇到新消息时应做什么。

如果通信双方独立发布,建议显式保留版本演进空间,例如新增字段时保持旧字段含义不变,避免复用已经下线的字段标识。二进制协议若依赖 schema,还要把 schema 版本纳入构建和发布流程;文本协议也不代表“无需 schema”,只是约束可能写在文档或验证层里。

用一个决策顺序落地

  1. 先看边界:面向公开 API、人工联调或多团队接入时,优先考虑可读性和通用工具支持。
  2. 再看成本:消息频率高、带宽敏感、序列化占用明显时,再测量二进制编码能节省多少 CPU 和流量。
  3. 再看演进:如果客户端版本长期并存,优先选择有成熟兼容规则的格式,而不是只追求当前最小包体。
  4. 最后做基准:用真实消息分布比较编码后大小、编码与解码耗时、内存分配和排障成本,再决定是否切换。

一个常见结果是:外部 HTTP API 使用 JSON,便于接入与排障;内部高频 RPC 使用带 schema 的二进制协议,降低传输和解析成本。它们并不冲突,因为不同系统边界本来就可以采用不同协议。

什么时候不要急着换成二进制

如果当前瓶颈来自数据库、锁竞争或下游延迟,把 JSON 换成二进制通常不会改变端到端耗时。先用性能数据确认序列化或网络已经进入主要成本,再承担协议迁移和兼容治理的复杂度。

协议选择最终是在“人能否轻松理解”和“机器能否高效处理”之间做工程权衡。优先满足系统边界与演进需求,再用测量结果决定是否为性能支付额外复杂度。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

选对文本还是二进制协议

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通