Avro 1.8.2升级至1.11.0时枚举联合类型默认值无效问题

这个异常是Avro版本升级后默认值校验规则收紧导致的：

• Avro 1.8.2对union类型字段的默认值校验逻辑宽松，存在隐式类型转换容错：即使误将null类型的默认值写为字符串"null"，该版本也会自动转换为合法null值处理，不会抛出异常。
• 从Avro 1.9.0版本开始（包含你使用的1.11.0），官方严格执行Avro规范校验，移除了上述容错逻辑：union类型的默认值必须和union定义中第一个类型的类型完全匹配，禁止跨类型隐式转换。
  从异常信息Invalid default for field errorType: "null" not a ["null",{"type":"enum","name":"ErrorEnum","namespace":"com.abc.xyz","symbols":["INFO","ERROR","UNKNOWN"]}]可以看出，运行时Avro实际解析到的errorType字段默认值是字符串类型的"null"（值带双引号标识为字符串），并非null类型对应的合法值，和union第一个位置声明的null类型不匹配，因此抛出类型异常。

常见触发场景有三类：

• 手写JSON Schema时笔误，给null加了双引号，写成"default": "null"
• Schema嵌套在YAML/Properties等配置文件中存储时，转义规则配置错误，导致JSON解析器将原生null识别为字符串"null"
• 编译期使用的Avro代码生成插件（如avro-maven-plugin）版本低于1.9，生成的Java类中默认值被硬编码为字符串"null"，和高版本运行时校验逻辑不兼容

根据实际的Schema定义场景选择对应方案即可：

• 手写JSON格式Schema：检查errorType字段的default配置，确保写法为"default": null，去掉null两侧的双引号。你贴出的Schema示例写法本身符合规范，大概率是实际运行时加载的Schema文件存在笔误，或被其他配置转义逻辑修改了值类型。
• Java代码动态构造Schema：调用Schema.Field构造方法设置默认值时，直接传入Java原生null，不要传入字符串"null"。
• 用Avro插件生成Java类：将构建工具（Maven/Gradle）中配置的Avro代码生成插件版本升级到和运行时一致的1.11.0，重新生成所有关联Bean类。
• Schema存放在YAML/Properties等第三方配置文件中：检查配置转义规则，确保整个Schema JSON被正确解析，不会将原生null值序列化为字符串。
• 修复后可通过调用Schema.Field#defaultVal()方法打印字段默认值，确认返回值是Java null而非字符串"null"，即可验证配置生效。

内容的提问来源于stack exchange，提问作者ondway