Node.js中ImapFlow通过OAuth2连接Outlook报错“connection not available”解决

我正在将基于node-imap的应用迁移至ImapFlow，原node-imap采用OAuth2.0连接Outlook服务器的代码如下：

const getImapConfig = (token) => {
  const mailId = 'NiceEmail@niceCompany.onmicrosoft.com';
  const auth2 = Buffer.from(
    [`user=${mailId}`, `auth=Bearer ${token.accessToken}`, '', ''].join('\x01'),
    'utf-8'
  ).toString('base64');
  const imapConfig = {
    xoauth2: auth2,
    host: 'outlook.office365.com',
    port: 993,
    // user: process.env.USER,
    // password: process.env.PASSWORD,
    tls: true,
    debug: console.log,
    authTimeout: 25000,
    connTimeout: 30000,
    tlsOptions: {
      rejectUnauthorized: false,
      servername: 'outlook.office365.com',
    },
  };

  return imapConfig;
};

当前我的ImapFlow代码如下，连接时出现错误：“connection not available”，请问应如何配置？

const getImapConfigForImapFlow = (token) => {
  const mailId = 'NiceEmail@niceCompany.onmicrosoft.com';
  const auth2 = Buffer.from(
    [`user=${mailId}`, `auth=Bearer ${token.accessToken}`, '', ''].join('\x01'),
    'utf-8'
  ).toString('base64');
  const imapConfig = {
    xoauth2: auth2,
    auth: {
      accessToken: auth2,
    },
    host: 'outlook.office365.com',
    port: 993,
    secure: true,
    logger: console.log,
    authTimeout: 25000,
    connTimeout: 30000,
    tls: {
      rejectUnauthorized: false,
    },
  };

  return imapConfig;
};
 const client = new ImapFlow(getImapConfigForImapFlow(token));
 const lock = await client.getMailboxLock('INBOX');

解决方案 #

• 错误核心原因：
  1. ImapFlow不需要手动构建xoauth2编码字符串，它支持直接传入用户邮箱和accessToken，手动编码会导致认证失败。
  2. 代码中同时设置了xoauth2和auth.accessToken字段，造成配置冲突。
  3. 缺少关键的client.connect()步骤，未建立连接就尝试获取邮箱锁，导致"connection not available"错误。

修正后的配置及代码：

const getImapConfigForImapFlow = (token) => {
  const mailId = 'NiceEmail@niceCompany.onmicrosoft.com';
  return {
    host: 'outlook.office365.com',
    port: 993,
    secure: true,
    auth: {
      user: mailId,
      accessToken: token.accessToken,
    },
    logger: console.log,
    authTimeout: 25000,
    connTimeout: 30000,
    tls: {
      rejectUnauthorized: false,
      servername: 'outlook.office365.com' // 保持servername配置避免TLS问题
    },
  };
};

// 正确的连接流程
const client = new ImapFlow(getImapConfigForImapFlow(token));
try {
  // 先建立连接
  await client.connect();
  // 连接成功后再获取邮箱锁
  const lock = await client.getMailboxLock('INBOX');
  try {
    // 在这里执行邮箱操作，比如读取邮件等
  } finally {
    // 释放锁
    lock.release();
  }
} catch (err) {
  console.error('连接或操作失败:', err);
} finally {
  // 关闭连接
  await client.close();
}

说明：

• ImapFlow的auth对象直接接收user和accessToken，内部会自动处理OAuth2的认证流程，无需手动构建xoauth2字符串。
• 必须先调用await client.connect()完成连接建立，才能进行后续的邮箱操作。
• 保持servername的TLS配置，避免Outlook服务器的SNI验证问题。

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