如何在Microsoft Graph API中对已发送邮件应用筛选器？

问题原因 #

你遇到的"未终止的字符串字面量"错误，本质是URL参数编码不规范或筛选语法的引号解析冲突导致Graph API无法正确解析$filter参数。手动拼接URL时，单引号、邮箱中的特殊字符（如@）未被正确编码，服务器会误认为字符串未闭合。

解决方案 #

1. 用Axios的params自动处理编码（推荐） #

不要手动拼接URL查询参数，让Axios自动处理编码，彻底避免编码错误：

const user = "你的用户ID或邮箱";
const targetEmail = "要筛选的收件人邮箱";

axios.get(`https://graph.microsoft.com/v1.0/users/${user}/mailFolders('sentitems')/messages`, {
  headers: {
    Authorization: `Bearer ${accessToken}` // MSAL获取的鉴权令牌
  },
  params: {
    $filter: `toRecipients/any(t:t/emailAddress/address eq '${targetEmail}')`
  }
});

2. 替换单引号为双引号并手动编码（备选） #

如果必须手动拼接URL，把筛选条件里的单引号换成双引号，同时对$filter参数做URL编码：

const user = "你的用户ID或邮箱";
const targetEmail = "要筛选的收件人邮箱";
const filterStr = `toRecipients/any(t:t/emailAddress/address eq "${targetEmail}")`;
const encodedFilter = encodeURIComponent(filterStr);

const requestUrl = `https://graph.microsoft.com/v1.0/users/${user}/mailFolders('sentitems')/messages?$filter=${encodedFilter}`;

axios.get(requestUrl, {
  headers: {
    Authorization: `Bearer ${accessToken}`
  }
});

关键说明 #

• Graph API支持单引号或双引号包裹字符串字面量，用双引号可避免和URL中可能的单引号转义冲突；
• Axios的params选项会自动对所有查询参数做URL编码，是最稳妥的方式，无需手动处理特殊字符；
• 确认targetEmail变量没有包含未转义的引号或其他特殊字符，若有需提前处理。

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