后台Worker服务初始化Cosmos Client时遇配置系统初始化失败错误

错误根源分析 #

异常核心是System.MissingMethodException: Cannot dynamically create an instance of type 'System.Configuration.ClientConfigurationHost'，本质是非.NET Framework环境（如.NET Core/.NET 5+）中，Cosmos SDK尝试调用仅适用于Framework的ConfigurationManager读取配置，而该环境下System.Configuration相关类型缺少必要的无参构造函数，导致配置系统初始化失败，进而终止进程。

解决方案 #

1. 确保使用适配的Cosmos SDK版本 #

升级到最新版Microsoft.Azure.Cosmos NuGet包（不要使用旧版Microsoft.Azure.DocumentDB），新版SDK针对.NET Core/.NET 5+做了适配，不会默认依赖System.Configuration。

2. 显式初始化CosmosClient并跳过自动配置读取 #

初始化时传入CosmosClientOptions，避免SDK自动读取配置文件，同时修正代码细节问题：

var endPoint = "https://endpoint-URI:443/"; // 修正URL格式，补全第二个/
var key = "api-Key";

// 显式配置客户端选项，跳过自动配置读取逻辑
var cosmosOptions = new CosmosClientOptions
{
    ConnectionMode = ConnectionMode.Gateway // 根据业务需求选择，Direct模式性能更优
};

// 传入选项初始化客户端
CosmosClient cosmosClient = new CosmosClient(endPoint, key, cosmosOptions);
var databaseName = "dbName";
var containerName = "containerName";
var container = cosmosClient.GetContainer(databaseName, containerName);

var upsertOrder = new
{
    id = Guid.NewGuid().ToString(), // Cosmos要求id为字符串类型，需显式转换
    Partition = "",
    Ticker = "ABC"
};

// 显式指定分区键，避免自动解析错误
var response = await container.CreateItemAsync(
    item: upsertOrder,
    partitionKey: new PartitionKey(upsertOrder.Partition)
);

3. 清理不必要的依赖 #

如果是.NET Core/.NET 5+项目，移除对System.Configuration.ConfigurationManager NuGet包的引用（除非业务确实需要兼容旧配置逻辑），避免环境冲突。

4. 额外排查点 #

• 清理NuGet缓存后重新安装Microsoft.Azure.Cosmos包，避免版本冲突
• 检查Worker Service的appsettings.json配置文件，确保没有格式错误或冲突项
• Worker Service中建议通过依赖注入获取IConfiguration，而非直接使用ConfigurationManager

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