引入Microsoft.Azure.Cosmos的CosmosClient后ASP.NET MVC应用无限加载

1. 异步调用死锁问题 #

你的CosmosGetDocument是异步方法，如果在ASP.NET MVC控制器或业务逻辑中用同步方式（如.Result、.Wait()）调用，会触发ASP.NET上下文死锁——主线程等待异步任务完成，而异步任务需要占用上下文才能继续执行，双方互相阻塞导致无限加载。

解决方法：
将整个调用链改为全异步模式，控制器方法必须标记为async Task<ActionResult>，用await调用异步方法：

public async Task<ActionResult> GetDocument(string id)
{
    var doc = await cosmosService.CosmosGetDocument(id, "target-collection");
    return View(doc);
}

2. CosmosClient初始化线程安全问题 #

当前静态client的初始化逻辑没有线程安全保障，多线程并发调用Initialize时，可能出现重复初始化、资源竞争导致的阻塞。

解决方法：
用Lazy<T>实现线程安全的延迟初始化，替代手动判断client == null的逻辑：

private static readonly Lazy<CosmosClient> _lazyCosmosClient = new Lazy<CosmosClient>(() =>
{
    TokenCredential credential;
    if (tokenEnv == "Local")
    {
        credential = new DefaultAzureCredential(new DefaultAzureCredentialOptions
        {
            ExcludeInteractiveBrowserCredential = true,
            ExcludeVisualStudioCredential = false,
            ExcludeVisualStudioCodeCredential = true,
            ExcludeAzurePowerShellCredential = true,
            ExcludeAzureCliCredential = true,
            ExcludeAzureDeveloperCliCredential = true,
            ExcludeWorkloadIdentityCredential = true,
            ExcludeEnvironmentCredential = true,
            ExcludeManagedIdentityCredential = true,
            ExcludeSharedTokenCacheCredential = true
        });
    }
    else
    {
        credential = new DefaultAzureCredential(new DefaultAzureCredentialOptions 
        { 
            ManagedIdentityClientId = WebConfigurationManager.AppSettings["kvMsiClientId"], 
            TenantId = WebConfigurationManager.AppSettings["tenantID"] 
        });
    }
    return new CosmosClient(endPointURL, credential);
});

public static CosmosClient Client => _lazyCosmosClient.Value;

之后直接通过Client属性获取实例，不再需要手动调用Initialize。

3. 凭证获取延迟问题 #

本地环境使用的VisualStudioCredential可能存在凭证加载延迟，甚至隐性交互请求（即使禁用了交互式浏览器凭证）。

解决方法：

1. 给CosmosClient添加请求超时配置，避免无限等待：

var clientOptions = new CosmosClientOptions
{
    RequestTimeout = TimeSpan.FromSeconds(10),
    ConnectionMode = ConnectionMode.Gateway // 若网络环境限制Direct模式，可切换为Gateway
};
return new CosmosClient(endPointURL, credential, clientOptions);

2. 本地测试时可临时启用环境变量凭证，设置AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET环境变量，然后将ExcludeEnvironmentCredential改为false，绕过VisualStudioCredential的潜在延迟。

4. 端点后台刷新阻塞问题 #

从输出日志看，GlobalEndpointManager在后台刷新端点列表，若网络不稳定或账户配置异常，可能导致后台线程占用资源，间接引发主线程阻塞。

解决方法：
如果你的CosmosDB是单区域账户，可禁用端点发现，减少后台刷新逻辑：

var clientOptions = new CosmosClientOptions
{
    EnableEndpointDiscovery = false,
    RefreshIntervalForEndpointDiscovery = TimeSpan.FromMinutes(30) // 多区域账户可延长刷新间隔
};
return new CosmosClient(endPointURL, credential, clientOptions);

5. 详细日志定位 #

启用CosmosDB详细日志，精准定位阻塞环节：
在Web.config中添加日志配置：

<system.diagnostics>
    <sources>
        <source name="DocDBTrace" switchName="DocDBTraceSwitch">
            <listeners>
                <add name="cosmosLogFile" type="System.Diagnostics.TextWriterTraceListener" initializeData="cosmos_debug.log"/>
            </listeners>
        </source>
    </sources>
    <switches>
        <add name="DocDBTraceSwitch" value="Verbose"/>
    </switches>
</system.diagnostics>

同时在CosmosGetDocument方法中添加时间戳日志，标记进入方法、开始读取、读取完成的节点，确认阻塞发生在哪个步骤。

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