Microsoft Graph .NET客户端库是否支持按正文及创建日期筛选邮件

结论 #

Microsoft Graph API 及对应 .NET 客户端库完全支持按 createdDateTime 和邮件正文筛选邮件，你遇到的 Bad Request 报错、匹配无结果问题均由筛选语句写法不规范导致，具体问题及修正方案如下：

1. createdDateTime 筛选错误原因及修正 #

你原始代码的问题有两点：

• Graph API 要求用于时间比较的参数必须是 ISO 8601 格式的 UTC 时间，你直接传入了本地时间的默认字符串格式，不符合接口要求直接触发 400 错误。
• 直接拼接用户输入的 subject 字符串，如果内容包含单引号会破坏 OData 筛选语法，同样会触发 Bad Request。

修正后的代码示例：

private static async Task<IMailFolderMessagesCollectionPage> GetMessages(string subject, int count)
{
    // 转义subject中的单引号，避免语法错误
    var escapedSubject = subject.Replace("'", "''");
    // 时间转成UTC+ISO 8601格式
    var timeThreshold = DateTime.UtcNow.AddMinutes(-10).ToString("o");
    return await graphServiceClient.Me.MailFolders.Inbox.Messages
        .Request()
        .Filter($"subject eq '{escapedSubject}' and createdDateTime gt {timeThreshold}")
        .Top(count)
        .GetAsync();
}

注意：时间参数不需要加单引号，ISO 8601 格式的时间在 OData 中是原生支持的类型。

2. 邮件正文筛选错误原因及修正 #

• 你第一版代码的问题：body 是复杂类型，包含 contentType 和 content 两个属性，不能直接对 body 本身用 contains 筛选，必须指定筛选 body/content 属性，你更新后的写法已经修正了这个问题。
• 你更新后仍匹配不到结果的常见原因：
  • 输入的 bodyPart 包含单引号未转义，导致筛选条件语法失效
  • body/content 默认返回 HTML 格式的正文内容，如果你要匹配的文本被 HTML 标签包裹、或者邮件正文是纯文本格式，会出现匹配失败。如果不需要精准匹配完整正文，建议替换为筛选 bodyPreview 属性（系统自动提取的纯文本正文摘要），匹配成功率更高：

    Filter($"subject eq '{escapedSubject}' and contains(bodyPreview, '{escapedBodyPart}')")
    

  • 部分 Exchange 环境对超长的正文内容筛选有长度限制，如果 bodyPart 过长也可能出现匹配失败。

通用注意事项 #

• 所有用户输入的字符串参数都要做单引号转义（把单个'替换为两个''），避免 OData 语法错误和注入风险。
• 不要用 .Result 同步等待异步请求，容易引发线程死锁，建议改为 await 异步调用。

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