使用Microsoft Graph API搜索SharePoint含空格文件名的文件失败

方案1：修正全局搜索（/search/query）的查询字符串 #

针对原请求的问题，调整查询字符串的写法：

• 只保留driveItem作为实体类型，减少不必要的结果干扰
• 将路径改为站点内相对路径并用双引号包裹，避免URL编码导致的解析问题
• 确保文件名的双引号包裹正确，强制作为完整关键词匹配

修改后的请求体：

{"requests": [
    {
        "entityTypes": [
            "driveItem"
        ],
        "query": {
            "queryString": "filename:\"foto 3.jpg\" AND path:\"/teams/MySite/Shared Documents/MyRootFolder/*\"",
            "contentSources": [
                "siteId:mysharepoint.sharepoint.com,<a guid>,<another guid>"
            ]
        }
    }
]
}

方案2：使用特定Drive的精准搜索接口 #

全局搜索的语法处理相对严格，改用目标站点Drive的专属搜索接口，能更精准地定位文件：

调用以下GET请求（替换占位符为实际值）：

GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root/search(q='filename:"foto 3.jpg" AND path:/MyRootFolder/*')

该接口的优势：

• 仅针对目标站点的Drive搜索，无需指定contentSources，减少范围歧义
• 路径支持相对Drive根目录的写法，避免完整URL的编码问题
• 文件名的空格匹配逻辑更直接，双引号包裹即可作为完整关键词

关键注意事项 #

• 必须用双引号包裹含空格的文件名，否则Graph会将其拆分为多个独立搜索词
• 路径部分避免使用URL编码（如%20），直接使用空格或相对路径更可靠
• 确认siteId参数完全正确，内容格式为{hostname},{site-collection-id},{site-id}

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