使用MailKit读取IMAP邮件时周期性触发OnImapProtocolException的原因

代码示例 #

DateTime deliveredAfterDate = ... some date value
using (var client = new ImapClient())
{
  client.Connect(_emailConfig.ImapServer, _emailConfig.ImapPort, true);
  client.Authenticate(_emailConfig.UserName, _emailConfig.Password);

  var inbox = client.Inbox;
  inbox.Open(FolderAccess.ReadOnly);

  var query = SearchQuery.DeliveredAfter(deliveredAfterDate);
  IList<UniqueId> emailIds = inbox.Search(query);
    
  foreach (var uid in emailIds)
  {    
      // Exception is thrown HERE
      var message = inbox.GetMessage(uid); // <-- HERE                               
      if (message == null)
      {
          continue;
      }

      // Save email in DB
      IncomingMail newMail = new IncomingMail()
      {
          MessageId = message.MessageId,
          Subject = message.Subject ?? string.Empty,
          FromName = message.From.Mailboxes.FirstOrDefault()?.Name ?? string.Empty,
          FromAddress = message.From.Mailboxes.FirstOrDefault()?.Address ?? string.Empty,
          Timestamp = message.Date.LocalDateTime, // .DateTime,
          TextBody = message.TextBody ?? string.Empty,
      };
      await repo.InsertMailAsync(newMail)
  }

  client.Disconnect(true);
}

问题场景 #

上述代码运行在Worker Service中，操作完成后每隔一分钟重复执行。多数情况下代码正常运行，邮件可被正确读取并保存至数据库，但会周期性抛出以下异常：

Exception generated. Caller Member Name: Read, Caller Path:
D:\eDirectorate\source\eProtocol\eProtocol.Service\Services\EmailReader.cs,
Caller Line Number: 146 11:50:27 ERROR Exception stack trace: at
MailKit.Net.Imap.ImapEngine.OnImapProtocolException() at
MailKit.Net.Imap.ImapEngine.Iterate() at
MailKit.Net.Imap.ImapFolder.GetMessage(UniqueId uid, CancellationToken
cancellationToken, ITransferProgress progress) at
eProtocol.Service.Services.EmailReader.Read() in
D:\eDirectorate\source\eProtocol\eProtocol.Service\Services\EmailReader.cs:line
88

11:50:27 ERROR FETCH failed: Internal error occurred. Refer to server
log for more information. [2024-03-15 11:50:27]

可能的原因 #

• IMAP服务器端内部故障：异常信息明确指出“Internal error occurred. Refer to server log for more information”，这是服务器端的问题。可能是服务器后台执行定时任务（如邮件索引、存储清理）时资源耗尽，或者邮件存储文件损坏、进程临时崩溃等，周期性出现说明故障与服务器的某个周期操作相关。
• 邮件数据损坏：搜索到的某封邮件本身存在格式错误或数据损坏，当调用GetMessage触发FETCH命令时，服务器解析该邮件失败，抛出内部错误。如果这封邮件是周期性发送的，就会导致异常定时出现。
• 请求频率与服务器资源冲突：每分钟一次的请求频率可能与服务器的资源调度窗口重合，比如服务器在特定时间点集中处理邮件投递、备份等任务，此时处理FETCH请求时触发了资源竞争，导致内部错误。
• 网络连接波动：虽然代码每次创建新连接，但网络临时波动可能导致连接状态异常，服务器在处理异常连接的FETCH请求时抛出内部错误。

建议处理方式 #

• 查看IMAP服务器日志：这是定位问题的核心，服务器日志会记录内部错误的具体触发点（如具体邮件ID、资源占用情况）。
• 添加异常捕获与重试机制：在GetMessage调用处增加try-catch块，对FETCH失败的情况重试1-2次，避免单次异常中断整个任务。
• 调整任务执行间隔：将执行间隔从1分钟调整为更长时间（如2-3分钟），降低对服务器的请求频率，减少资源冲突概率。
• 定位异常邮件：捕获异常时记录当前的uid，如果多次异常指向同一个UID，说明该邮件存在问题，可手动登录邮箱排查或删除该邮件。

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