Heroku运行Node.js调用Mailinabox IMAP报连接数超限如何解决

触发连接超限的核心原因是IMAP连接泄漏：现有代码仅在邮件拉取成功的正常分支关闭连接，异常场景下连接未被正确释放，叠加每分钟定时触发的逻辑，累计超过Mailinabox默认的单用户单IP40个连接上限就会报错。Gmail未报错是因为其允许的单用户连接上限远高于40。

需要做的代码修改 #

1. 新增执行锁避免并行连接 #

增加运行状态标记，避免上一次邮件检查还没执行完，下一次定时任务又触发新建连接的情况：

// 全局运行状态标记
let isCheckingMail = false;

new CronJob('0 * * * * *', function() {  
    // 上一次检查还在运行就直接跳过本次
    if (isCheckingMail) return;
    checkmail();
}); 

2. 全场景覆盖连接关闭逻辑 #

在所有异常分支都新增连接关闭操作，同时增加超时兜底强制销毁连接，避免僵尸连接累积：

// 修正原代码语法错误：去掉了多余的等于号
function checkmail() {
    isCheckingMail = true;
    const imap = new Imap({
        user: 'myusername@mywebsite.com',
        password: 'mypassword',
        host: 'imap.mywebsite.com',
        port: myport,
        tls: true
    });

    // 30秒超时兜底，强制销毁连接
    const connTimeout = setTimeout(() => {
        imap.destroy();
        console.log('IMAP connection timeout, forced destroy');
    }, 30000);

    function openInbox(cb) {
        imap.openBox('INBOX', true, cb);
    }
 
    imap.once('ready', function() {
        openInbox(function(err, box) {
            if (err) {
                console.log('Open inbox error: ' + err);
                imap.end();
                return;
            }
            const f = imap.seq.fetch('1:3', {
                bodies: 'HEADER.FIELDS (FROM TO SUBJECT DATE)',
                struct: true
            });
            f.on('message', function(msg, seqno) {
                // 原有业务逻辑保持不变
            });
            f.once('error', function(err) {
                console.log('Fetch error: ' + err);
                imap.end();
            });
            f.once('end', function() {
                console.log('Done fetching all messages!');
                imap.end();
            });
        });
    });
 
    imap.once('error', function(err) {
        console.log('IMAP error: ' + err);
        imap.end();
    });
 
    imap.once('end', function() {
        clearTimeout(connTimeout);
        isCheckingMail = false;
        console.log('Connection ended');
    });
}

3. 可选优化：长期复用单连接 #

如果业务允许，可以不用每次定时任务都新建连接，而是全局维护一个常驻IMAP连接，连接断开时自动重连，从根源上避免频繁新建连接导致的计数累积。

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