SharePoint Online获取指定文件夹项时触发列表视图阈值超出错误

在SharePoint Online环境中，我尝试通过CamlQuery的FolderServerRelativeUrl属性指定目标文件夹，递归获取该文件夹下所有列表项，但触发了List View Threshold Exceeded Error（列表视图阈值超限错误）。相关代码如下：

var camlQuery = new CamlQuery
{
    ViewXml = "<View Scope='RecursiveAll'><RowLimit>" + chunkSize + "</RowLimit></View>"
};

context.Load(list, x => x.ItemCount);
context.Load(list, x => x.Title);
var fetchedCount = 0L;
var uniqueRolesCount = 0L;
do
{
    camlQuery.FolderServerRelativeUrl = FolderServerRelativeUrl;
    var targetItems = list.GetItems(camlQuery);
    context.Load(targetItems);
    context.Load(targetItems, x => x.Include(y => y.HasUniqueRoleAssignments));
    context.ExecuteQuery();

解决方法 #

1. 基于索引字段实现游标分页

SharePoint默认列表视图阈值为5000条，当查询返回项数超过该值且未使用索引字段过滤时会触发错误。即便指定了文件夹，也需要结合索引字段（比如ID、Created）来分段拉取数据，同时利用ListItemCollectionPosition实现游标分页，避免一次性加载过多内容：

修改后的完整代码示例：

var camlQuery = new CamlQuery
{
    // 添加按索引字段ID排序的查询，确保分页逻辑有效
    ViewXml = "<View Scope='RecursiveAll'><Query><OrderBy><FieldRef Name='ID' Ascending='True'/></OrderBy></Query><RowLimit>" + chunkSize + "</RowLimit></View>",
    FolderServerRelativeUrl = FolderServerRelativeUrl
};

context.Load(list, x => x.ItemCount);
context.Load(list, x => x.Title);
var fetchedCount = 0L;
var uniqueRolesCount = 0L;
ListItemCollectionPosition paginationPosition = null;

do
{
    camlQuery.ListItemCollectionPosition = paginationPosition;
    var targetItems = list.GetItems(camlQuery);
    // 同时加载ListItemCollectionPosition用于下一页查询
    context.Load(targetItems, 
        items => items.Include(item => item.HasUniqueRoleAssignments),
        items => items.ListItemCollectionPosition);
    context.ExecuteQuery();
    
    // 处理当前批次的列表项
    foreach (var item in targetItems)
    {
        if (item.HasUniqueRoleAssignments)
        {
            uniqueRolesCount++;
        }
        fetchedCount++;
    }
    
    // 更新分页位置，直到没有下一页
    paginationPosition = targetItems.ListItemCollectionPosition;
} while (paginationPosition != null);

2. 缩小查询范围

• 如果不需要递归获取所有子文件夹的项，将Scope='RecursiveAll'改为Scope='Default'（仅当前文件夹）或Scope='FilesOnly'（仅当前文件夹的文件），减少返回的项数。
• 检查目标文件夹内的实际项数，如果总数超过5000，必须通过索引字段分页，无法绕过阈值限制。

3. 临时提升阈值（仅管理员操作）

站点集管理员可以临时调整列表的视图阈值，但这会增加服务器负载，仅适合临时处理大量数据的场景，不推荐作为常规解决方案。

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