avro c++ 不支持直接解析二进制 schema，因 avro schema 本质是 json 字符串；.avro 文件头中嵌入的是 utf-8 编码的 json 字节流，需手动跳过 magic 和长度头后提取并传给 compilejsonschemafrommemory。
Avro C++ 里没有直接解析二进制 Schema 的 API
Avro 的 Schema 从来不是以二进制形式定义的——它必须是 JSON 格式字符串（或等价的 avro::ValidSchema 对象）。所谓“二进制 Schema”是个常见误解：实际二进制文件（.avro）开头嵌入的是 JSON Schema 的 **序列化字节**（即先 JSON → UTF-8 bytes，再写入文件头），不是某种 Avro 编码后的二进制 schema。C++ 的 avro::compileJsonSchemaFromMemory 或 avro::compileJsonSchemaFromFile 只接受原始 JSON 字符串或文件路径，不接受任意二进制流。
从 .avro 文件中提取并解析内嵌 Schema
Avro DataFile（Object Container File）格式规定：前 16 字节为 magic bytes（"Obj\x01"），紧接着是 4 字节长度字段，然后是 UTF-8 编码的 JSON Schema 字节流。要拿到它，得手动跳过 magic 和长度头：
- 用
std::ifstream以std::ios::binary打开文件 - 读取 16 字节，确认是否为
"Obj\x01"（注意末尾是 null byte，不是字符串 "Obj1"） - 再读 4 字节，用
avro::decodeLength（或手动ntohl处理）得到 schema length - 分配 buffer，读取对应长度的 bytes，确保末尾有
\0，转成std::string后传给avro::compileJsonSchemaFromMemory
别用 std::string::c_str() 直接传——如果中间有 <p>别用 <code>std::string::c_str() 直接传——如果中间有 \0 会截断；必须传 str.data() 和 str.size()。
str.data() 和 str.size()。
avro::ValidSchema 构造后不能直接当 JSON 字符串用
avro::ValidSchema 是解析后的内部表示，不提供反向导出 JSON 的接口。如果你需要调试或比对 schema，得在解析前保留原始 JSON 字符串副本。常见错误是以为调用 schema.toJson(true) 能返回可读 JSON——这个方法不存在；C++ 版本目前无公开的 schema 序列化能力（Java 版才有 toString()）。
- 调试时建议把原始 JSON 存在变量里，比如
const std::string schemaJson = R"({"type":"record","name":"Event",...})"; - 生成
ValidSchema后仅能通过schema.root()->type()、schema.root()->name()等有限接口查结构 - 字段顺序、默认值、命名空间等元信息一旦解析失败，错误提示非常简陋（如
Exception: Cannot resolve type），需回溯原始 JSON 检查语法和引用
Schema 解析失败最常卡在命名空间和类型引用
Avro C++ 对命名空间处理比 Java 严格：如果 schema 中用了 "namespace": "com.example"，所有后续 "type": "com.example.Event" 引用必须完整匹配，不能省略 namespace；同时，递归引用或前向声明（如 record 内部引用自身）需显式用 {"type": "array", "items": "Self"} 并配合 avro::resolveNames ——但 C++ 的 resolver 不自动触发，得手动构造 avro::Names 并传入。
- 错误现象：
Exception: Cannot resolve type 'Event'，即使 JSON 里明确定义了{"name": "Event", "type": "record", ...} - 原因：没设 namespace，或引用时写了
"Event"但定义时是"com.example.Event" - 修复方式：统一用完整限定名，或在顶层加
"namespace": "x"并确保所有引用带"x."前缀
真正难 debug 的点在于：解析成功不代表 runtime 安全——字段名拼错、类型不匹配（如 schema 写 "int" 但 C++ 成员是 int64_t）会在后续 encode/decode 阶段才报错，且堆栈不指向 schema 行号。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
