SharePoint Online GetListItemChangesSinceToken API服务器端ArgumentException异常求助

我们的Outlook插件调用SharePoint Online REST API的GetListItemChangesSinceToken接口操作文档库时出现异常。近期在多个环境中，该请求返回服务器端System.ArgumentException错误，导致插件在多家客户组织中功能失效。

复现特征 #

• 上传特定文档capitalization table.xlsx到不同SharePoint文档库后，调用接口必现错误
• 同一文档上传到OneDrive则无此问题

请求示例 #

POST https://ravenwooddemo.sharepoint.com/projectsandmeetings/projects/_api/Web/GetList(@a1)/GetListItemChangesSinceToken?@a1='%2fprojectsandmeetings%2fprojects%2fRavenwood+HQ' HTTP/1.1

{"query":{"ViewFields":"<ViewFields><FieldRef Name=\"ID\" /></ViewFields>","RowLimit":"1000"}}

响应示例 #

{"error":{"code":"-2147024809, System.ArgumentException","message":{"lang":"en-US","value":"Value does not fall within the expected range."}}}

排查与解决方向 #

1. 检查文档元数据 #

capitalization table.xlsx可能携带了SharePoint不兼容的元数据：

• 打开文档属性（右键→属性→详细信息），清理超长、特殊字符或不符合字段类型的属性值
• 对比OneDrive和目标SharePoint库的字段配置，确认是否有SharePoint强制要求的必填字段或验证规则，而文档未满足

2. 调整API请求参数 #

GetListItemChangesSinceToken对参数格式要求严格，尝试以下调整：

• 在请求体中添加ChangeToken参数（传空字符串""即可），部分环境下该参数为隐含必填项，不传会触发参数异常
  修改后的请求体：

  {"query":{"ViewFields":"<ViewFields><FieldRef Name=\"ID\" /></ViewFields>","RowLimit":"1000", "ChangeToken":""}}
  

3. 排查文档库配置问题 #

• 测试新建空白SharePoint文档库，上传该文档后调用接口，排除现有库的版本控制、内容审批、IRM等特殊配置影响
• 检查库中是否有自定义字段或事件接收器，可能与接口逻辑冲突

4. 修复文档本身 #

• 将文档另存为新文件（避免直接复制），清除隐藏数据或损坏格式
• 重命名文档为capitalization_table.xlsx（去掉空格），测试是否是文件名特殊字符导致解析错误

5. 替代方案与官方支持 #

如果以上方法无效，可能是SharePoint Online服务端bug：

• 尝试使用Graph API的/sites/{site-id}/lists/{list-id}/items/delta接口替代，该接口功能类似且兼容性更好
• 收集完整请求日志（含请求头、租户ID、库ID），提交给Microsoft 365官方支持团队定位问题

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