调用MS Graph获取Outlook收件箱邮件时提示"Invalid filter clause"错误

你的API请求里有个很容易忽略的语法问题，直接导致了这个错误，咱们来一步步搞定它：

问题出在哪？ #

先看你当前的请求URL：

https://graph.microsoft.com/v1.0/me/mailFolders/Inbox/messages ?$filter=isRead eq false?$select=subject,body

这里的核心错误是多个查询参数之间的分隔符用错了。当你需要同时使用$filter和$select这类参数时，它们之间应该用&连接，而不是第二个?$。你现在的写法会让API把false?$select=subject,body当成$filter条件的一部分，这显然不符合过滤规则，所以才会抛出"Invalid filter clause"。

修正后的正确请求URL #

把第二个?$替换成&就搞定了，正确的URL如下：

https://graph.microsoft.com/v1.0/me/mailFolders/Inbox/messages?$filter=isRead eq false&$select=subject,body

额外小提示 #

• 关于URL编码：你提到用%20替换空格，其实大多数HTTP客户端会自动帮你处理空格的编码，不过如果是手动构造URL，写成isRead%20eq%20false也是完全没问题的，两种方式都能被API正确识别。
• 权限验证：如果修正后还是报错，记得检查一下你的请求是否已经获取了Mail.Read权限，这是读取邮件内容必需的权限。

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