MailKit的SearchQuery.SubjectContains方法查询收件箱返回邮件数量异常

核心原因：IMAP服务器单次搜索结果上限 #

绝大多数主流邮件服务提供商（包括Gmail、Exchange、Outlook、各类企业邮箱等）都会对IMAP SEARCH命令的单次返回结果数量做限制，避免单次请求负载过高，你遇到的168条就是对应服务商的单次搜索返回上限，和代码本身的搜索逻辑无关，两次不同写法返回数量一致也印证了这一点。

解决方法：分段区间搜索 #

通过拆分UniqueId的查询范围，分多次批量搜索再合并结果，即可拿到所有匹配的邮件，兼容所有支持标准IMAP协议的服务器，示例代码如下：

var inbox = ImapClient.Inbox;
await inbox.OpenAsync(FolderAccess.ReadWrite, CancellationToken.None);

var allMatchingUids = new List<UniqueId>();
// 先获取当前收件箱的全部UID范围
var uidRange = await inbox.GetUidRangeAsync(0, -1, CancellationToken.None);
if (uidRange == null || !uidRange.Any())
    return;

uint minUid = uidRange.Min().Id;
uint maxUid = uidRange.Max().Id;
// 每次查询1000个UID区间，可根据服务商实际限制调整步长
const uint step = 1000;

for (uint currentStart = minUid; currentStart <= maxUid; currentStart += step)
{
    uint currentEnd = Math.Min(currentStart + step - 1, maxUid);
    // 组合区间条件+主题搜索条件
    var rangeQuery = SearchQuery.UidRange(new UniqueId(currentStart), new UniqueId(currentEnd))
        .And(SearchQuery.SubjectContains("RandomName"));
    
    var partialResult = await inbox.SearchAsync(rangeQuery, CancellationToken.None);
    allMatchingUids.AddRange(partialResult);
}

其他可排查点 #

• 确认查询的是目标收件箱：多账号场景下可能拿错了ImapClient.Inbox对应的账号实例，可先打印inbox.Count对比当前收件箱总邮件数是否和实际一致
• 确认搜索规则匹配：部分服务商的主题搜索默认区分大小写，或者会自动忽略特殊符号，可先拉取你确认存在的目标邮件的主题原文，对比搜索关键词是否符合匹配规则
• 排除特殊邮件过滤：部分IMAP服务器默认搜索会自动过滤已标记为删除、归档的邮件，如果你需要包含这类邮件，可以在查询条件中添加对应的状态匹配规则，或者调整服务器端的IMAP搜索配置

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