使用Microsoft Graph API SDK过滤SharePoint List报Invalid filter clause如何解决

错误原因及修复方案 #

1. 直接报错原因 #

你当前代码存在两处语法错误：

• 带空格的SharePoint字段不能直接写空格，需将空格替换为_x0020_，或直接使用字段内部名
• 扩展字段的查询参数需加$前缀，你写的expand应为$expand

2. 按修改日期区间过滤的正确实现 #

你的核心需求是返回两个指定时间范围内的记录，使用Graph API的ge（大于等于）和le（小于等于）运算符过滤系统自带的Modified字段即可，日期需采用ISO 8601格式的UTC时间。
修正后代码示例：

GraphServiceClient graphClient = new GraphServiceClient(authProvider);
// 定义时间范围，替换为你实际需要的UTC时间
DateTime startUtc = new DateTime(2024,1,1,0,0,0,DateTimeKind.Utc);
DateTime endUtc = new DateTime(2024,6,1,0,0,0,DateTimeKind.Utc);

var queryOptions = new List<QueryOption>()
{
  new QueryOption("$expand","fields"),
  // 按修改时间区间过滤
  new QueryOption("$filter",$"fields/Modified ge {startUtc:o} and fields/Modified le {endUtc:o}")
  // 如果你需要同时过滤自定义文本字段，写法如下，注意替换为你的字段内部名
  // new QueryOption("$filter",$"fields/Modified ge {startUtc:o} and fields/Modified le {endUtc:o} and fields/Field_x0020_1 eq 'Field 1 value'")
};
var aa = await graphClient.Sites["{xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx}"].Lists[sharepointlistid].Items.Request(queryOptions).GetAsync();

注意事项 #

• 自定义字段优先使用内部名：可进入SharePoint列表设置，点击对应字段名称，地址栏中Field=后面的参数值就是字段内部名，避免空格转义错误
• 过滤字段需提前添加索引：进入SharePoint列表设置的「索引」页面，为你用于过滤的字段添加索引，否则大数据量下列表会拒绝过滤请求
• 时间过滤默认匹配UTC时间：如果用本地时间请先转换为UTC格式，避免时间差导致的结果匹配错误

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