Graph API获取SharePoint列表项时startsWith等函数Filter子句失效问题

startsWith 类字符串函数本身支持在 SharePoint 对应的 Microsoft Graph API $filter 查询中使用，你遇到报错是查询语法错误导致的。

错误原因 #

startsWith 属于字符串过滤函数，不是比较运算符，你使用的 fields/Title startsWith 'test' 写法不符合 Graph API 的函数调用规范，所以触发无效过滤子句错误。

正确查询示例 #

你可以直接使用以下格式的请求完成前缀匹配查询：

/sites/{site-id}/lists/{list-id}/items?$expand=fields&$filter=startsWith(fields/Title, 'test')

其他注意事项 #

• 所有 Graph API 的过滤函数名严格区分大小写，必须全小写开头，不能写为StartsWith这类大写开头的形式
• 除startsWith外，contains、endsWith等常用字符串过滤函数也支持在该场景下使用，均需遵循函数名(字段, 参数)的调用格式
• 过滤自定义字段时需要匹配列表实际的内部字段名，避免字段名拼写错误导致过滤失效

内容的提问来源于stack exchange，提问作者t-mori