能否在.NET Core依赖注入中安全使用CosmosClient.CreateAndInitializeAsync？

针对你在AKS部署场景下的需求——既要利用CreateAndInitializeAsync降低首次请求延迟，又要避免同步调用阻塞应用启动、瞬时异常导致启动失败，下面是几种实用方案：

1. 带异常处理的异步工厂模式注册单例 #

直接在ConfigureServices里用异步工厂模式注册CosmosClient，同时捕获瞬时异常，避免启动失败：

services.AddSingleton<CosmosClient>(sp =>
{
    var config = sp.GetRequiredService<IConfiguration>();
    var endpoint = config["CosmosDb:Endpoint"];
    var key = config["CosmosDb:Key"];
    var client = new CosmosClient(endpoint, key);

    // 异步初始化并处理瞬时异常
    return Task.Run(async () =>
    {
        try
        {
            await client.CreateAndInitializeAsync(
                databasesToInitialize: new[] { "你的数据库名" },
                containersToInitialize: new[] { ("你的数据库名", "你的容器名") }
            );
        }
        catch (CosmosException ex) when (ex.StatusCode is System.Net.HttpStatusCode.ServiceUnavailable or System.Net.HttpStatusCode.TooManyRequests)
        {
            // 记录日志，允许客户端后续自动重试
            sp.GetRequiredService<ILogger<CosmosClient>>().LogWarning(ex, "CosmosDB初始化暂时失败，将在首次请求时自动重试");
        }
        return client;
    }).GetAwaiter().GetResult();
});

这种方式会在注册时完成初始化，但通过捕获瞬时异常，不会因为CosmosDB临时不可用导致应用启动失败；同时CreateAndInitializeAsync提前建立连接，降低后续请求延迟。

2. 延迟初始化（首次请求时执行） #

把初始化逻辑延迟到首次使用CosmosClient的时候，完全避免启动阶段的阻塞或失败：

// 包装类，负责延迟初始化
public class CosmosClientWrapper
{
    private readonly CosmosClient _client;
    private readonly ILogger<CosmosClientWrapper> _logger;
    private readonly Task _initTask;

    public CosmosClientWrapper(CosmosClient client, ILogger<CosmosClientWrapper> logger)
    {
        _client = client;
        _logger = logger;
        _initTask = InitializeAsync();
    }

    private async Task InitializeAsync()
    {
        try
        {
            await _client.CreateAndInitializeAsync(
                new[] { "你的数据库名" },
                new[] { ("你的数据库名", "你的容器名") }
            );
        }
        catch (CosmosException ex) when (ex.StatusCode is System.Net.HttpStatusCode.ServiceUnavailable or System.Net.HttpStatusCode.TooManyRequests)
        {
            _logger.LogWarning(ex, "CosmosDB初始化暂时失败，后续请求会自动重试");
        }
    }

    // 获取客户端，确保初始化完成后再使用
    public CosmosClient GetClient()
    {
        _initTask.Wait();
        return _client;
    }
}

// 在ConfigureServices中注册
services.AddSingleton<CosmosClient>(sp =>
{
    var config = sp.GetRequiredService<IConfiguration>();
    return new CosmosClient(config["CosmosDb:Endpoint"], config["CosmosDb:Key"]);
});
services.AddSingleton<CosmosClientWrapper>();

之后在业务代码中注入CosmosClientWrapper，调用GetClient()获取实例即可。应用启动时不会执行初始化，第一次请求时才完成初始化，适合对启动速度要求高的场景。

3. .NET 6+ 启动阶段异步初始化 #

如果你的项目基于.NET 6或更高版本，可以直接在Program.cs的启动流程中执行异步初始化，逻辑更清晰：

var builder = WebApplication.CreateBuilder(args);

// 提前创建CosmosClient并执行异步初始化
var cosmosEndpoint = builder.Configuration["CosmosDb:Endpoint"];
var cosmosKey = builder.Configuration["CosmosDb:Key"];
var cosmosClient = new CosmosClient(cosmosEndpoint, cosmosKey);

try
{
    await cosmosClient.CreateAndInitializeAsync(
        new[] { "你的数据库名" },
        new[] { ("你的数据库名", "你的容器名") }
    );
}
catch (CosmosException ex) when (ex.StatusCode is System.Net.HttpStatusCode.ServiceUnavailable or System.Net.HttpStatusCode.TooManyRequests)
{
    // 记录警告日志，不中断启动
    builder.Logging.Services.BuildServiceProvider().GetRequiredService<ILogger<Program>>()
        .LogWarning(ex, "CosmosDB初始化暂时失败，首次请求时会自动重试");
}

// 注册单例CosmosClient
builder.Services.AddSingleton(cosmosClient);

var app = builder.Build();
// 配置中间件...
app.Run();

这种方式在应用启动早期完成初始化，但同样通过异常处理避免启动失败，兼顾了初始化优化和启动稳定性。

关键注意事项 #

• 无论哪种方案，都要针对瞬时异常（如服务不可用、请求超限）做捕获处理，这些异常通常是暂时的，CosmosDB SDK后续会自动重试
• 即使CreateAndInitializeAsync失败，CosmosClient实例仍然可用，后续的数据库/容器操作会自动触发初始化或重试
• 结合AKS的Pod重启场景，建议保留初始化日志，方便排查启动阶段的CosmosDB连接问题

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