导入CSV到SharePoint列表每10分钟报429运行时错误如何解决

问题原因 #

429错误是SharePoint Online的节流保护机制触发导致的，微软对SPO API的请求频率、资源占用量设置了动态阈值，批量数据导入的高频率请求很容易触及阈值被限制访问。

现有代码问题 #

你当前的代码仅配置了身份凭证、UserAgent和无限请求超时，缺少核心的节流重试逻辑，触发429后没有等待机制直接抛出异常，同时加载全量子网站的请求资源消耗极高，容易触发节流。

修复方案 #

1. 新增429异常指数退避重试逻辑 #

捕获429异常时读取响应头的Retry-After字段，按照官方要求的等待时间重试，无该字段时采用指数退避策略增加等待时长，避免频繁重试加剧限制。
参考实现代码如下：

// 全局配置：最大重试次数
private const int MaxRetryCount = 5;

ctx.Credentials = new SharePointOnlineCredentials(userName, sec_pass);
ctx.ExecutingWebRequest += delegate (object sender, WebRequestEventArgs e)
{
    e.WebRequestExecutor.WebRequest.UserAgent = "NONISV|Den|Migration/1.0";
};
// 替换无限超时为5分钟超时，避免请求堆积
ctx.RequestTimeout = 300000;

ctx.Load(ctx.Web);
// 非必要场景删除下行代码，加载所有子网站属于高消耗请求，极易触发节流
// ctx.Load(ctx.Web.Webs);

// 使用带重试的方法替换原生ExecuteQuery
ExecuteQueryWithRetry(ctx, MaxRetryCount);

/// <summary>
/// 支持SPO节流重试的ExecuteQuery封装
/// </summary>
public static void ExecuteQueryWithRetry(ClientContext ctx, int maxRetry)
{
    int retryAttempts = 0;
    int baseDelay = 1000; // 初始延迟1秒
    while (retryAttempts < maxRetry)
    {
        try
        {
            ctx.ExecuteQuery();
            return;
        }
        catch (WebException ex) when ((ex.Response as HttpWebResponse)?.StatusCode == (HttpStatusCode)429)
        {
            // 读取官方返回的建议等待时间，单位转换为毫秒
            var retryAfterVal = (ex.Response as HttpWebResponse).Headers["Retry-After"];
            int waitMilliseconds = retryAfterVal != null 
                ? int.Parse(retryAfterVal) * 1000 
                : baseDelay * (int)Math.Pow(2, retryAttempts);
            Thread.Sleep(waitMilliseconds);
            retryAttempts++;
        }
    }
    throw new InvalidOperationException("多次重试后仍触发SPO节流限制，请降低导入速率后重试");
}

2. 导入场景优化建议 #

• 合并批量请求：不要单条数据提交一次请求，每次批量处理100-200条列表项后再调用ExecuteQuery，减少总请求次数
• 降低并发数：多线程导入场景下并发数不要超过3，单线程导入稳定性更高
• 避开高峰时段：工作日9-18点的节流阈值更严格，非高峰时段执行导入任务的限制更少

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