Spring Boot集成Azure Schema Registry序列化失败问题求助

AI 小北

2026-6-30

问题原因与解决方案

核心原因

你遇到的SerializationException根因是调用Azure Schema Registry的REST接口时，请求未明确指定接收JSON格式响应，导致Azure Schema Registry默认返回XML格式的Schema内容，而你的客户端用Jackson（默认处理JSON）解析XML引发报错。

本地Test Containers测试正常，是因为Test Containers环境下的Schema Registry模拟服务默认返回JSON，或者测试客户端默认携带了正确的Accept请求头；而AKS部署环境中，客户端请求未设置该头，触发了Azure Schema Registry的默认XML响应逻辑。

解决步骤

1. 配置客户端请求头为JSON格式

使用Azure Schema Registry的Java客户端（或Spring Boot Starter）时，需显式指定请求的Accept头为application/json：

若使用Spring Cloud Azure Schema Registry Starter，在application.properties/application.yml中添加配置：

spring.cloud.azure.schema-registry.client.accept=application/json

若直接使用Azure SDK for Java的SchemaRegistryClient，初始化时通过HttpClient配置请求头：

HttpClient httpClient = new DefaultHttpClientBuilder()
    .addHeader("Accept", "application/json")
    .build();
SchemaRegistryClient client = new SchemaRegistryClientBuilder()
    .endpoint("<your-schema-registry-endpoint>")
    .credential(new DefaultAzureCredentialBuilder().build())
    .httpClient(httpClient)
    .build();