C# 访问 SharePoint 365 现代体验站点列表时 ExecuteQuery 报运行时超时错误

排查步骤 #

• 验证网络连通性：在运行代码的设备上通过浏览器直接访问目标SharePoint站点，确认可以正常登录并查看站点内容，排除本地网络代理、防火墙拦截、VPN未连通等基础网络问题。
• 验证账号权限：确认代码中使用的账号对目标站点有至少只读权限，账号无锁定、无多因素认证拦截（如果开启了MFA，需要改用应用密码或其他认证方式）。
• 验证CSOM包版本：确认项目中引用的Microsoft.SharePointOnline.CSOMNuGet包为最新正式版，老旧版本对现代SharePoint 365站点兼容性不足，容易引发请求异常。

解决方案 #

1. 修复站点URL格式错误 #

你现有代码中的站点URL为https:siteurl，属于格式错误，需要填写完整的站点路径，正确格式示例：https://租户名.sharepoint.com/sites/站点名，URL格式错误会导致请求无法正常到达服务端，最终触发超时。

2. 手动延长请求超时时间 #

CSOM默认请求超时时间较短，你可以在初始化ClientContext后手动设置超时时长，示例代码如下：

// 单位为毫秒，此处设置为5分钟超时，可根据实际场景调整
clientContext.RequestTimeout = 300000;

3. 优化列表查询逻辑 #

如果站点下存在大量列表，一次性拉取所有列表会拉长响应耗时，你可以增加过滤条件，排除隐藏的系统列表，优化查询效率：

clientContext.Load(web.Lists,
    lists => lists.Where(l => !l.Hidden)
                  .Include(list => list.Title, list => list.Id));

4. 增加现代站点兼容配置 #

针对SharePoint 365现代体验站点，可以添加以下配置提升请求兼容性：

clientContext.DisableReturnValueCache = true;
clientContext.ValidateOnClient = false;

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