使用C# EWS获取多文件夹邮件时添加SearchFilter报错排查

我之前也踩过EWS筛选文件夹的类似坑，结合你的场景来拆解问题和给出解决方案：

首先明确你的问题场景：你想用Exchange Web Services (EWS) 从收件箱、已发送邮件和几个自定义文件夹里拉取邮件，思路是先筛选目标文件夹再循环调用FindItems。但只要加上第10行的searchFilter4（筛选"Sent"文件夹）就会抛出ServiceResponseException，移除就正常运行。

先把你的代码片段贴出来方便大家理解：

// 用于筛选收件箱、Completed、Inprogress及已发送邮件文件夹的名称筛选器：
SearchFilter searchFilter1 = new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Inbox");
SearchFilter searchFilter2 = new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Completed");
SearchFilter searchFilter3 = new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Inprogress");
SearchFilter searchFilter4 = new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Sent");

// 组合筛选器
SearchFilter folderFilter = new SearchFilter.SearchFilterCollection(LogicalOperator.Or, 
    searchFilter1, searchFilter2, searchFilter3, searchFilter4);

// 获取目标文件夹
FindFoldersResults findFolderResults = service.FindFolders(WellKnownFolderName.MsgFolderRoot, folderFilter, new FolderView(100));

// 循环获取邮件
foreach (Folder folder in findFolderResults.Folders)
{
    ItemView itemView = new ItemView(100);
    FindItemsResults<Item> findItemsResults = folder.FindItems(itemView);
    // 处理邮件逻辑...
}

问题根源分析 #

这个异常大概率是已发送邮件文件夹的特殊属性导致的：

• 已发送邮件文件夹的默认显示名称不是你写的"Sent"——Exchange会根据区域/语言本地化这个名称，比如英文环境是"Sent Items"，中文环境是"已发送邮件"，如果你的Exchange环境里实际名称和你写的"Sent"不匹配，筛选时就会触发异常。
• 更关键的是，已发送邮件是Exchange的默认系统文件夹，这类文件夹不建议通过显示名称筛选，因为用户可能修改过显示名称，或者环境本地化后名称不一致，直接用WellKnownFolderName.SentItems才是最稳妥的方式。

另外，你可以通过捕获异常查看详细错误信息，这一步能帮你精准定位问题：

try
{
    // 你的文件夹查找和邮件获取逻辑
}
catch (ServiceResponseException ex)
{
    Console.WriteLine($"错误代码：{ex.Response.ErrorCode}");
    Console.WriteLine($"错误消息：{ex.Response.Message}");
    Console.WriteLine($"详细错误：{ex.Response.DetailedMessage}");
}

解决方案 #

方案1：分开处理系统文件夹和自定义文件夹（推荐） #

直接用WellKnownFolderName.SentItems获取已发送文件夹，再和自定义文件夹的筛选结果合并，这样能避免显示名称不匹配的问题：

// 筛选自定义文件夹：Inbox、Completed、Inprogress
SearchFilter customFolderFilter = new SearchFilter.SearchFilterCollection(LogicalOperator.Or,
    new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Inbox"),
    new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Completed"),
    new SearchFilter.IsEqualTo(FolderSchema.DisplayName, "Inprogress"));

FindFoldersResults customFolders = service.FindFolders(WellKnownFolderName.MsgFolderRoot, customFolderFilter, new FolderView(100));

// 单独绑定已发送邮件系统文件夹
Folder sentFolder = Folder.Bind(service, WellKnownFolderName.SentItems);

// 合并所有目标文件夹
List<Folder> targetFolders = customFolders.Folders.ToList();
targetFolders.Add(sentFolder);

// 循环处理每个文件夹的邮件
foreach (Folder folder in targetFolders)
{
    ItemView itemView = new ItemView(100);
    FindItemsResults<Item> findItemsResults = folder.FindItems(itemView);
    // 处理你的邮件逻辑...
}

方案2：确认已发送文件夹的真实显示名称再筛选 #

如果你一定要用显示名称筛选，先确认Exchange环境中已发送文件夹的真实名称：

1. 先运行一段代码列出所有顶层文件夹，查看已发送文件夹的DisplayName：

FindFoldersResults allFolders = service.FindFolders(WellKnownFolderName.MsgFolderRoot, new FolderView(100));
foreach (Folder f in allFolders.Folders)
{
    Console.WriteLine($"文件夹名称：{f.DisplayName}，文件夹ID：{f.Id}");
}

2. 把searchFilter4中的"Sent"替换成你查到的真实显示名称（比如英文环境换成"Sent Items"）。

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