这个二进制检查器能处理什么?
本工具在结构化 JSON 与三种常见二进制序列化格式之间转换。Avro 依赖明确的模式定义记录与基础类型;MessagePack 和 CBOR 则在编码值中携带类型信息。解码后的字节串和超出 JavaScript 安全整数范围的数值会显示为带标记的 JSON 对象,避免精度或原始字节被静默丢失。
如何检查或创建二进制消息
- 1选择 Avro、MessagePack 或 CBOR,再选择从 JSON 编码还是解码已有字节。
- 2处理 Avro 时先粘贴准确的写入端模式;没有模式就无法可靠解释 Avro 记录。
- 3编码时输入普通 JSON;需要精确类型时可使用 $bigint 或 $bytes 标记对象。
- 4解码时选择十六进制或 Base64,并粘贴不含传输协议头的完整消息。
- 5检查解码 JSON、字节数和格式错误,确认结果后再复制使用。
常见二进制序列化工作流
调试事件载荷
直接解码从队列或数据流捕获的消息,无需在生产者或消费者中临时添加日志。
检查 Avro 模式兼容性
用指定 Avro 模式编码代表性记录,定位缺失字段、无效联合类型和基础类型不匹配。
创建协议测试样本
生成确定的十六进制与 Base64 样本,用于文档、单元测试、命令行请求或跨语言互操作检查。
常见问题
为什么 Avro 必须提供模式?
Avro 二进制记录按照模式给出的字段顺序与类型紧凑存储值。缺少匹配的写入端模式时,无法安全还原字段边界和含义。
大整数和字节串如何显示?
大整数显示为包含十进制字符串的 $bigint;字节显示为 $bytes Base64 和 $hex 文本。这些标记对象也可直接用于编码。
成功解码能证明消息可信吗?
不能。解码只说明字节能被所选编解码器和模式解释,不会认证来源、验证签名,也不会判断业务字段是否有效。