Graph API筛选含撇号文件名失败问题求助

当需要筛选名称包含单撇号的SharePoint站点页面时，OData筛选器的转义规则需要严格遵循以下步骤：

1. 转义单撇号：在OData字符串中，单撇号必须用两个连续的单撇号('')转义，因此原始名称Students'-Cook-Off-at-Exeter-and-Creative-Leftovers.aspx需转为：

   Students''-Cook-Off-at-Exeter-and-Creative-Leftovers.aspx
   

2. URL编码转义后的字符串：将转义后的字符串进行URL编码，此时双撇号会被编码为%27%27，最终的$filter参数为：

   filter=name eq 'Students%27%27-Cook-Off-at-Exeter-and-Creative-Leftovers.aspx'
   

3. 完整调用链接：

   https://graph.microsoft.com/beta/sites/{siteId}/pages/microsoft.graph.sitePage?filter=name eq 'Students%27%27-Cook-Off-at-Exeter-and-Creative-Leftovers.aspx'
   

排查注意事项 #

• 确认目标页面的name字段与查询值完全匹配（包括大小写、特殊字符，无额外空格）
• 若仍无结果，可先调用无筛选的列表接口/sites/{siteId}/pages/microsoft.graph.sitePage，核对页面的实际name值
• 避免直接对原始单撇号编码为%27后再处理，这会触发OData语法错误

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