如何通过IMAP按批次获取iCloud邮箱最新的N条邮件

要按从新到旧的顺序、以10条为一批获取iCloud邮件，核心是利用IMAP序列号的规则：序列号1对应邮箱中最旧的邮件，最新邮件的序列号等于邮箱的总邮件数（即box.messages）。我们可以从总邮件数倒推每一批的区间，逐步分批获取。

修改后的完整代码 #

const imapConfig = {
  user: 'xxxx@icloud.com',
  password: 'xxx-xxxx-xxxx-xxxx',
  host: 'imap.mail.me.com',
  port: 993,
  tls: true,
};
const imap = new Imap(imapConfig);
const batchSize = 10; // 每批获取10条

function openInbox(cb) {
  imap.openBox('INBOX', true, cb);
}

function fetchBatch(startSeq, endSeq) {
  // 修正边界：如果起始序列小于1，强制设为1
  const actualStart = Math.max(startSeq, 1);
  const fetchOptions = {
    bodies: '',
    markSeen: false,
    struct: true,
  };

  console.log(`获取第 ${actualStart} 到 ${endSeq} 条邮件（从新到旧）`);
  const f = imap.seq.fetch(`${actualStart}:${endSeq}`, fetchOptions);

  f.on('message', (msg, seqno) => {
    console.log('Message #%d', seqno);
    // 可在此添加邮件内容解析逻辑
    msg.on('body', (stream, info) => {
      let buffer = '';
      stream.on('data', chunk => buffer += chunk.toString('utf8'));
      stream.on('end', () => {
        console.log(`邮件 ${seqno} 内容摘要：`, buffer.slice(0, 200)); // 截断显示避免过长
      });
    });
  });

  f.on('error', err => {
    console.error('批次获取失败：', err);
  });

  f.on('end', () => {
    // 计算下一批区间：往前偏移10条
    const nextEnd = actualStart - 1;
    const nextStart = nextEnd - batchSize + 1;
    if (nextEnd >= 1) {
      // 还有未获取的邮件，继续取下一批
      fetchBatch(nextStart, nextEnd);
    } else {
      // 所有邮件处理完成，关闭连接
      imap.end();
      console.log('全部邮件获取完成');
    }
  });
}

imap.once('ready', () => {
  openInbox((err, box) => {
    if (err) {
      console.error('打开收件箱失败：', err);
      imap.end();
      return;
    }
    const totalMessages = box.messages;
    if (totalMessages === 0) {
      console.log('收件箱为空');
      imap.end();
      return;
    }
    // 初始化第一批：从最新的10条开始
    const firstEnd = totalMessages;
    const firstStart = firstEnd - batchSize + 1;
    fetchBatch(firstStart, firstEnd);
  });
});

imap.once('error', err => {
  console.error('IMAP连接出错：', err);
});

imap.once('end', () => {
  console.log('IMAP连接已关闭');
});

imap.connect();

关键逻辑说明 #

• 批次区间计算：
  • 初始批次的结束序列是总邮件数（对应最新邮件），起始序列为总邮件数 - 9（确保取满10条）；若总邮件数不足10，则起始序列自动修正为1。
  • 每批处理完成后，下一批的结束序列是当前批次起始序列减1，起始序列再往前推10条，直到结束序列小于1时停止。
• 递归分批：通过fetchBatch的递归调用，实现自动触发下一批获取，无需手动干预。
• 异常处理：覆盖了收件箱为空、连接失败、批次获取失败等场景，避免程序崩溃。

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