spring-cloud-schema-registry-client Avro转换失败异常排查

核心认知偏差 #

你混淆了Spring Cloud Stream组件和Spring MVC组件的适用场景：
AvroSchemaMessageConverter是Spring Cloud Stream为消息中间件绑定场景设计的消息转换器，默认不会注册到Spring MVC的HttpMessageConverter列表中，自然无法处理控制器的HTTP请求/响应序列化。官方文档描述的「开箱即用自动推断Schema」能力，仅针对Spring Cloud Stream的消息收发场景，不覆盖Spring MVC的HTTP接口场景。

直接报错触发原因 #

1. 你配置的spring.cloud.stream.bindings.output.contentType属于Spring Cloud Stream输出通道的专属配置，和Spring MVC的内容协商、响应序列化逻辑完全无关，不会对控制器返回值生效。
2. 接口返回值为ResponseEntity<List<Employee>>，Java泛型擦除后Spring MVC在序列化阶段拿到的目标类型是原生Arrays$ArrayList，既没有匹配的转换器，就算手动注册了转换器也无法从无泛型信息的集合类推断出内部Employee元素的Avro Schema，最终抛出找不到转换器的异常。
3. 你的启动类注解存在拼写错误：@EnableSchemRegistryClient遗漏了字符a，正确写法为@EnableSchemaRegistryClient，但该注解仅负责激活Spring Cloud Stream相关的Schema Registry客户端逻辑，不会自动为Spring MVC注册Avro格式的HTTP消息转换器。

分步修复步骤 #

• 手动注册Avro HTTP消息转换器到Spring MVC
  新建配置类实现WebMvcConfigurer接口，重写extendMessageConverters方法，实例化支持Avro格式的HttpMessageConverter，指定其支持的MediaType包含application/avro、自定义的application/emp.v1+avro等你需要的格式，再把转换器加入到转换器列表中。
• 解决集合类型泛型擦除问题
  两种方案二选一即可：
  • 定义专用的包装POJO，例如EmployeeList类，内部持有List<Employee> employees字段，接口直接返回ResponseEntity<EmployeeList>，Avro可以直接从POJO结构生成完整Schema，不存在泛型擦除问题
  • 如果必须返回裸集合，需要自定义转换器的类型解析逻辑，序列化集合时显式指定内部元素类型为Employee.class，为Avro提供生成Schema必需的类型信息
• 精简配置
  删除spring.cloud.stream.bindings相关的无效配置，仅保留spring.cloud.schema.avro.dynamicSchemaGenerationEnabled: true即可，开启动态Schema生成后，只要能拿到明确的序列化目标类型，不需要手动提前注册Schema，转换器会自动根据POJO字段生成对应Avro Schema。

测试注意事项 #

使用MockMvc做测试时，如果用的是@WebMvcTest切片测试注解，需要显式导入你编写的WebMvcConfigurer配置类，否则切片上下文扫描不到你手动注册的Avro转换器，依然会抛出找不到转换器的异常。

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