avro 默认值机制对枚举字段的向后兼容支持有限；仅当新消息中出现旧 schema 未定义的枚举符号时，读取失败——即使声明了 default，也必须确保 reader schema 的 symbols 完全覆盖 writer schema 中实际出现的符号。
avro 默认值机制对枚举字段的向后兼容支持有限；仅当新消息中出现旧 schema 未定义的枚举符号时，读取失败——即使声明了 default，也必须确保 reader schema 的 symbols 完全覆盖 writer schema 中实际出现的符号。
在 Avro 中，枚举（enum）类型的向后兼容性（即用旧 schema 读取新 schema 写入的数据）并非由 default 值自动保障，而是严格依赖 symbol 名称的精确匹配。关键点在于：Avro 的 default 仅在字段缺失（missing field）时生效，而非在字段存在但 symbol 不被 reader schema 认可时兜底。
例如，你定义 base schema（v1）：
{
"name": "ColorType",
"type": "enum",
"symbols": ["BLUE", "YELLOW", "GREEN", "UNKNOWN"],
"default": "UNKNOWN"
}
而 writer 使用扩展 schema（v2）写入 "BLACK"：
{
"name": "ColorType",
"type": "enum",
"symbols": ["BLUE", "YELLOW", "GREEN", "BLACK", "UNKNOWN"],
"default": "UNKNOWN"
}
当 v1 reader 尝试解析含 "BLACK" 的 JSON 或二进制数据时，JsonDecoder.readEnum() 会直接抛出 AvroTypeException: Unknown symbol in enum BLACK —— 因为 "BLACK" 不在 v1 的 symbols 列表中，default 不触发。
✅ 正确兼容的前提是：writer 必须只使用 reader schema 中已声明的 symbols。如示例中用 v2 schema 写入 "yellow"，而 v1 schema 包含 "yellow"（注意大小写），则可成功降级读取：
# v1.avsc 包含 "unknown","red","blue","green" # v2.avsc 新增 "yellow"，但 v2 消息中若写入的是 v1 已有的 "red" java -jar avro-tools-1.11.1.jar tojson --reader-schema-file v1.avsc v2.avro # ✅ 成功
⚠️ 注意事项：
- default 仅作用于字段不存在场景（如 JSON 中省略该字段），不处理 symbol 不识别；
- 枚举扩展必须遵循 "添加符号，不删除/重命名" 原则，且所有 producer 必须约束自身只发送 reader 兼容的值；
- 生产环境推荐配合 Schema Registry（如 Confluent）启用 FULL 兼容性检查，它会在注册 v2 schema 时自动拒绝破坏兼容性的变更（如移除 symbol）；
- 更健壮的设计是：将枚举字段设为 union 类型，例如 ["null", "ColorType"]，并配合逻辑层 fallback 处理未知值。
总结：Avro 的枚举兼容性本质是静态符号白名单机制，而非动态 fallback。所谓“full compatibility”要求 writer 和 reader 协同约定——writer 不发新 symbol，reader 通过 default 应对字段缺失。真正的弹性需结合应用层兜底（如映射到 UNKNOWN 枚举）或采用更宽松的类型（如 string）+ 文档约束。
