如何使用AddSearchClient<TBuilder,TConfiguration>重载配置Azure Cognitive Search客户端

核心解决方案：用ConfigureOptions自定义SearchClientOptions #

如果要在注册SearchClient时同时配置连接参数（URI、索引名、密钥）和SearchClientOptions（比如自定义序列化器），不需要依赖AddSearchClient<TBuilder,TConfiguration>这个配置对象重载，直接用带Action<SearchClientOptions>的扩展方法更灵活直观。

示例代码如下：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAzureClients(b =>
{
    // 注册SearchClient并配置选项
    b.AddSearchClient(
        new Uri("https://" + searchServiceConfiguration.Host),
        searchServiceConfiguration.IndexName,
        new AzureKeyCredential(searchServiceConfiguration.QueryApiKey))
    .ConfigureOptions(options =>
    {
        // 配置自定义序列化器
        options.Serializer = new JsonObjectSerializer(
            new JsonSerializerOptions
            {
                PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
            });
        // 可在此添加其他SearchClientOptions的配置项
    });

    // 同理配置SearchIndexClient
    b.AddSearchIndexClient(
        new Uri("https://" + searchServiceConfiguration.Host),
        new AzureKeyCredential(searchServiceConfiguration.AdminApiKey))
    .ConfigureOptions(options =>
    {
        // 按需配置SearchIndexClient的选项
    });
});

关于AddSearchClient<TBuilder,TConfiguration>重载的说明 #

这个重载主要用于从配置文件（如appsettings.json）绑定配置节，TConfiguration需要匹配Azure SDK定义的配置模型结构（通常对应SearchClientSettings类，包含服务URI、索引名、密钥配置路径等）。但这种方式对自定义SearchClientOptions的支持不够直接，远不如ConfigureOptions灵活，因此不推荐用于你的场景。

关键结论 #

你需要的序列化器配置完全可以通过ConfigureOptions方法传入，同时能完整指定URI、索引名、密钥等必要参数，实现你想要的全部配置效果。

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