使用C#查询DocumentDB遇System.TypeInitializationException异常求解决

Hey，遇到System.TypeInitializationException这种异常确实挺头疼的，它通常是某个类型的静态构造函数执行失败，或者静态成员初始化出问题导致的。不过从你的代码来看，更可能是DocumentClient初始化过程中触发了底层的类型初始化错误，而外层的异常把真实原因给掩盖了。给你几个针对性的排查和修复步骤：

1. 先抓出真正的错误根源 #

你的catch块直接throw，完全没输出任何有用的异常信息——这可是大忌！TypeInitializationException的InnerException才是真正的罪魁祸首，先修改代码把它打出来：

static void Main(string[] args) {
    try {
        DocumentClient client = new DocumentClient(new Uri(EndpointUrl), PrimaryKey);
        var query = client.CreateDocumentQuery(
            "dbs/myDB/colls/myColl",
            "SELECT c.TestRun.dateFinish FROM c order by c.TestRun.dateFinish desc").ToList();
        Console.ReadLine();
    } catch (Exception ex) {
        // 把完整的异常信息打出来，别再直接抛了
        Console.WriteLine($"外层异常：{ex.Message}");
        if (ex.InnerException != null) {
            Console.WriteLine($"真实异常：{ex.InnerException.Message}");
            Console.WriteLine($"异常堆栈：{ex.InnerException.StackTrace}");
        }
        Console.ReadLine();
        // 先看日志，暂时别抛了
        // throw;
    }
}

运行后你就能看到到底是证书错了、配置不对还是SDK出问题了，这一步是关键！

2. 先检查最基础的配置 #

别小看配置错误，这是最常见的原因：

• 确认EndpointUrl是完整的，格式必须是https://你的账户名.documents.azure.com:443/，别漏了https://和端口443，也别多打空格。
• 确认PrimaryKey是从Azure门户复制的主密钥/只读密钥，复制的时候别带前后空格，那串长字符一个都不能错。

3. 调整DocumentClient的初始化参数 #

旧版的DocumentClient（属于Microsoft.Azure.DocumentDB NuGet包）在某些环境下（比如内网、有代理的场景）需要额外的连接配置，比如：

var connectionPolicy = new ConnectionPolicy
{
    ConnectionMode = ConnectionMode.Direct,
    ConnectionProtocol = Protocol.Tcp,
    AllowEndpointDiscovery = false // 如果是固定端点，关掉自动发现
};
// 带着连接策略初始化client
DocumentClient client = new DocumentClient(new Uri(EndpointUrl), PrimaryKey, connectionPolicy);

另外，如果你还在用旧SDK，真心建议你换成新版的Microsoft.Azure.Cosmos包，用CosmosClient替代DocumentClient——它不仅初始化更简单，还修复了一堆旧版本的bug：

// 先安装Microsoft.Azure.Cosmos NuGet包哦
using Microsoft.Azure.Cosmos;

static void Main(string[] args) {
    try {
        CosmosClient client = new CosmosClient(EndpointUrl, PrimaryKey);
        var container = client.GetContainer("myDB", "myColl");
        // 新版SDK用异步方法更规范，这里用.Result只是为了适配你的同步代码
        var query = container.GetItemQueryIterator<dynamic>(
            "SELECT c.TestRun.dateFinish FROM c order by c.TestRun.dateFinish desc").ReadNextAsync().Result.ToList();
        Console.ReadLine();
    } catch (Exception ex) {
        // 同样打印异常详情
        Console.WriteLine($"异常信息：{ex.Message}");
        if (ex.InnerException != null) {
            Console.WriteLine($"真实异常：{ex.InnerException.Message}");
        }
        Console.ReadLine();
    }
}

4. 检查NuGet包和.NET版本兼容性 #

• 如果你还在用旧的Microsoft.Azure.DocumentDB包，赶紧更到最新稳定版，旧版本可能有已知的初始化bug。
• 确认你的.NET框架版本和SDK兼容：比如旧版SDK可能不支持.NET Core 3.1以上，或者需要特定的.NET Framework版本，别硬凑。

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