C#连接SharePoint站点首次ExecuteQuery请求耗时100秒问题咨询

API 探路者

2026-10-1

SharePoint CSOM首次ExecuteQuery100秒延迟问题解决方案

问题根因

该现象90%以上是.NET运行时默认开启的Web代理自动检测（WPAD） 导致的：

系统默认会先尝试检索本地/网络的WPAD代理配置，该步骤的默认超时阈值恰好为100秒左右
代理检测逻辑在所有HTTP请求发起前执行，和后续SharePoint认证、接口请求逻辑无关，因此就算用户名密码错误，也需要等待检测超时才会返回错误
检测期间程序处于网络IO等待状态，因此CPU占用为0、内存无波动

修复方案

1. 禁用全局代理自动检测

二选一即可，推荐优先用配置文件方案：

配置文件方案（.NET Framework/.NET Core桌面应用）

在App.config/Web.config的<configuration>节点下新增如下配置：

<system.net>
  <defaultProxy enabled="false" useDefaultCredentials="false">
    <proxy />
  </defaultProxy>
</system.net>

代码全局设置方案

在程序入口的最开头（所有网络请求执行前）添加如下代码：

// 禁用默认全局代理，跳过WPAD检测
System.Net.WebRequest.DefaultWebProxy = null;

2. 强制指定TLS 1.2协议

SharePoint Online强制要求TLS 1.2加密，禁用低版本TLS协议协商可以进一步减少首次请求耗时，同样在程序入口处添加：

System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

3. 后台预热优化（可选）

如果对用户操作的响应速度要求较高，可以在程序启动时启动后台任务提前做一次轻量CSOM请求预热，将首次耗时转移到后台：

// 后台预热示例
_ = Task.Run(() =>
{
    try
    {
        using var preContext = new ClientContext(SITE_URL);
        preContext.Credentials = new SharePointOnlineCredentials(username, password);
        // 仅拉取最小必要的站点信息，降低预热开销
        preContext.Load(preContext.Web, w => w.Id);
        preContext.ExecuteQuery();
    }
    catch
    {
        // 预热失败不影响主业务逻辑
    }
});