SharePoint Online中GetFolderByServerRelativeUrl的$top参数失效问题

问题原因 #

直接调用/Files端点时，该集合无默认索引排序机制，当文件数超过5000时，SharePoint无法处理无索引的分页请求，导致$top/$skip参数失效并触发列表视图阈值错误。

可行解决方案 #

方案1：通过列表Items端点结合文件夹ID过滤

文件在SharePoint中本质是文档库的列表项，可直接查询列表的Items集合，通过文件夹的列表项ID过滤文件，同时使用带索引的字段（如ID）排序，实现分页获取。

步骤：

1. 先获取目标文件夹的列表项ID：

   _api/Web/GetFolderByServerRelativeUrl('/sites/site/Proceedings/ID of proceeding')/ListItemAllFields/ID
   

2. 用该ID过滤文件，分页获取所有文件及字段：

   _api/Web/Lists/GetByTitle('Proceedings')/Items?$filter=FSObjType eq 0 and FolderId eq '{FolderListItemId}'&$expand=File,ListItemAllFields&$orderby=ID asc&$top=5000&$skip={SkipCount}
   

   • FSObjType eq 0：筛选文件（文件夹为1）
   • FolderId eq '{FolderListItemId}'：仅获取目标文件夹下的文件
   • $orderby=ID asc：按ID排序（ID为默认索引字段，避免阈值）
   • 每次请求$top=5000，递增$skip值（如0、5000、10000...）直到返回结果为空。

方案2：使用CAML查询指定文件夹路径

通过CAML查询直接指定文件夹路径，同时指定带索引的排序字段和分页大小，绕过/Files端点的限制。

API调用示例：

_api/Web/Lists/GetByTitle('Proceedings')/GetItems(query=@v1)?@v1={'ViewXml':'<View><Query><Where><Eq><FieldRef Name=\'FSObjType\' /><Value Type=\'Integer\'>0</Value></Eq></Where><OrderBy><FieldRef Name=\'ID\' Ascending=\'True\' /></OrderBy></Query><RowLimit>5000</RowLimit><FolderServerRelativeUrl>\'/sites/site/Proceedings/ID of proceeding\'</FolderServerRelativeUrl></View>'}

• <FolderServerRelativeUrl>：指定目标文件夹的服务器相对路径
• <RowLimit>5000</RowLimit>：每次返回5000条数据
• <OrderBy>：按ID排序（依赖索引避免阈值）
• 若需要包含子文件夹的文件，添加<ViewScope>Recursive</ViewScope>到<View>标签内；仅需当前文件夹则用<ViewScope>FilesOnly</ViewScope>。

注意事项 #

• 确保排序字段（如ID、Created）已添加索引（ID为SharePoint默认索引字段，无需额外配置）；若使用其他字段排序，需提前在文档库设置中为该字段添加索引。
• 分页时需记录已获取的条目数，递增$skip值（方案1）或处理CAML的分页游标（方案2），直到没有新数据返回。

内容的提问来源于stack exchange，提问作者Fausto Sánchez Hoya