Azure Functions v2调用类库时DocumentClient加载类型异常排查

这个问题确实是**.NET版本差异**导致的兼容性问题，同时和你使用的Azure Cosmos DB SDK版本密切相关，下面给你详细拆解和解决办法：

为什么会抛出这个异常？ #

System.Diagnostics.Eventing.EventProviderTraceListener是.NET Framework专属的类型，.NET Core/.NET Standard的运行时环境中并没有包含这个类型。而你使用的旧版DocumentClient（来自Microsoft.Azure.DocumentDB包）在初始化过程中，会尝试加载这个.NET Framework特有的跟踪监听器，当在Azure Function v2（基于.NET Core/.NET Standard）的运行时环境下执行时，就会因为找不到该类型而抛出异常。

推荐的解决方案：升级到最新的Azure Cosmos DB SDK #

这是最彻底的解决办法，因为新版SDK完全支持.NET Standard/.NET Core，同时也兼容.NET Framework 4.7，能从根源上避免这类跨平台兼容性问题：

• 第一步：在你的.NET Framework 4.7工具类库中，卸载旧的Microsoft.Azure.DocumentDB NuGet包，安装Microsoft.Azure.Cosmos包（选择支持.NET Framework 4.7的版本，目前最新稳定版都支持）。
• 第二步：修改类库中的代码，替换DocumentClient为CosmosClient，调整相关逻辑。比如原来的初始化代码：

  _client = new DocumentClient(new Uri(cosmosDbEndpoint), cosmosDbAuthKey, Storage.SerializerSettings, connectionPolicy);
  

  可以改成新版SDK的写法：

  var cosmosClientOptions = new CosmosClientOptions
  {
      SerializerOptions = new CosmosSerializationOptions
      {
          // 对应原来的SerializerSettings，按需配置
          PropertyNamingPolicy = CosmosPropertyNamingPolicy.CamelCase
          // 其他序列化设置
      },
      ConnectionMode = ConnectionMode.Gateway, // 对应原来的connectionPolicy中的连接模式
      // 其他连接相关配置
  };
  _client = new CosmosClient(cosmosDbEndpoint, cosmosDbAuthKey, cosmosClientOptions);
  

• 第三步：在你的Azure Function v2项目中，同样安装Microsoft.Azure.Cosmos NuGet包，确保和工具类库使用的版本一致，避免版本冲突。

临时兼容方案（不推荐） #

如果暂时无法升级SDK，你可以尝试在Azure Function项目中添加一个空的EventProviderTraceListener类型定义，来绕过这个加载错误：

namespace System.Diagnostics.Eventing
{
    public class EventProviderTraceListener : System.Diagnostics.TraceListener
    {
        // 空实现必要的方法
        public override void Write(string message) {}
        public override void WriteLine(string message) {}
    }
}

但这个方案只是权宜之计，后续可能会遇到更多.NET Framework专属类型缺失的问题，所以还是优先推荐升级SDK。

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