Jakarta Mail的MessageCountListener对企业Outlook邮箱失效问题

我基于Jakarta Mail 2.0.1开发了一款Java邮件通知工具，通过ImapFolder.addMessageCountListener()实现新邮件监听逻辑，核心代码如下：

folder.addMessageCountListener(new MessageCountAdapter() {
    @Override
    public void messagesAdded(MessageCountEvent ev) {
        //处理收到的新邮件
    }
});

同时在单独线程中执行IDLE命令维持连接：

while (!stopNotificationListener && !Thread.interrupted()) {
    try {
        notificationFolder.idle();
    } catch (FolderClosedException e) {
        noopThread.shutdown();
        logger.error("与服务器断开连接，正在重新连接。");
    }
}

测试个人Outlook、Gmail邮箱均正常，但企业版Outlook邮箱的addMessageCountListener完全不触发，调试日志显示连接成功进入IDLE状态，但未收到新邮件通知。

针对不同邮件服务器（尤其是Exchange/企业Outlook这类有严格连接管控的服务），需遵循以下规则：

1. 为IDLE操作单独分配线程 #

Jakarta Mail的idle()方法会阻塞当前线程，若同一线程执行其他IMAP操作，会导致监听逻辑异常：

• 必须为IDLE循环单独创建线程，确保该线程仅负责维持IDLE状态
• messagesAdded中的新邮件处理逻辑需放到独立业务线程执行，避免阻塞IDLE循环

2. 定期刷新IDLE连接 #

部分企业服务器会在长时间IDLE后静默断开或停止推送事件，需主动刷新：

• 设置15-30分钟的IDLE超时，超时后调用idle(false)中断当前IDLE，发送NOOP命令刷新连接后重新进入IDLE
• 示例定时刷新代码：

ScheduledExecutorService idleScheduler = Executors.newSingleThreadScheduledExecutor();
// 每25分钟刷新一次IDLE连接
idleScheduler.scheduleAtFixedRate(() -> {
    if (notificationFolder != null && notificationFolder.isOpen()) {
        try {
            notificationFolder.idle(false); // 中断IDLE
            notificationFolder.doCommand(protocol -> {
                protocol.noop();
                return null;
            });
        } catch (MessagingException e) {
            logger.error("刷新IDLE连接失败", e);
        }
    }
}, 25, 25, TimeUnit.MINUTES);

3. 完善异常处理与重连逻辑 #

企业服务器可能因权限策略、网络波动强制断开连接：

• 在IDLE循环中捕获所有MessagingException子类（不止FolderClosedException），如ConnectionException、ProtocolException
• 重连时需重新创建IMAPStore、打开Folder、重新注册监听，禁止复用旧连接对象
• 重连后执行EXAMINE或SELECT命令同步文件夹状态，再进入IDLE

4. 适配Exchange/企业Outlook的特殊配置 #

从日志看服务器支持IDLE，但需调整以下配置：

• 以READ-WRITE模式打开文件夹（而非EXAMINE只读模式），部分Exchange环境下只读模式会限制事件推送：

folder.open(Folder.READ_WRITE); // 替换原有的只读打开方式

• 添加Jakarta Mail配置参数适配Exchange：

mail.imap.connectiontimeout=30000
mail.imap.timeout=30000
mail.imap.idleautorefresh=true # 自动刷新IDLE连接
mail.imap.usesocketchannels=true # 提升连接稳定性

5. 验证服务器事件推送 #

若以上调整无效，需手动验证服务器推送机制：

• 在IDLE状态下用其他客户端发送邮件到目标邮箱，查看调试日志是否收到* EXISTS或* RECENT的服务器推送
• 若无推送，需联系企业邮件管理员确认是否存在邮件过滤、IMAP事件推送禁用等权限限制

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