SharePoint Online GetItems POST API突然忽略$top和$skip参数求助

问题根源 #

当使用POST请求调用_api/Web/Lists(guid'428350ec-589a-46d3-973a-fa6dc2e52f04')/GetItems时，如果请求体中的SP.CamlQuery包含ViewXml节点，且该节点内存在<RowLimit>或其他分页相关的CAML配置，SharePoint Online会优先采用CAML的分页规则，忽略URL中的$top和$skip参数。近期的SPO服务更新可能强化了这种参数优先级逻辑，导致之前正常的请求失效。

解决方案 #

以下是无需大规模修改UI或切换到CAML分页的修复方法：

1. 移除ViewXml中的分页配置
   检查你的ViewXml内容，删除其中的<RowLimit>标签以及任何与分页相关的<QueryOptions>设置。示例：

   • 原ViewXml（会引发冲突）：

     <View>
       <RowLimit>50</RowLimit>
       <Query>
         <Where><Eq><FieldRef Name='Status'/><Value Type='Text'>Active</Value></Eq></Where>
       </Query>
     </View>
     

   • 修改后ViewXml：

     <View>
       <Query>
         <Where><Eq><FieldRef Name='Status'/><Value Type='Text'>Active</Value></Eq></Where>
       </Query>
     </View>
     

   移除后，URL中的$top=10和$skip=5参数会正常生效。

2. 设置超大RowLimit兼容URL参数
   如果必须保留ViewXml中的其他配置（比如特定查询条件或视图字段），可以将<RowLimit>设置为一个远大于业务需求的数值（例如10000，SPO列表视图的默认最大限制），这样SharePoint不会触发CAML分页，转而遵循URL的$top和$skip控制结果集。示例：

   <View>
     <RowLimit>10000</RowLimit>
     <Query>
       <Where><Eq><FieldRef Name='Status'/><Value Type='Text'>Active</Value></Eq></Where>
     </Query>
   </View>
   

3. 验证请求头配置
   确保请求的Content-Type设置正确，推荐使用：

   Content-Type: application/json;odata=nometadata
   

   错误的Content-Type可能导致SharePoint无法正确解析URL中的OData参数。

4. 隔离测试定位问题
   发送一个不带ViewXml的测试请求，仅保留URL参数和FolderServerRelativeUrl，确认$top和$skip是否正常工作：

   {
     "query": {
       "FolderServerRelativeUrl": "/sites/your-site/documents/folder1"
     }
   }
   

   如果此请求正常，即可确认是ViewXml中的分页配置导致的冲突。

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