使用Node.js的imapflow获取Office365邮箱列表时出现LSUB失败错误

可能的故障原因 #

• ImapFlow版本兼容性问题
  你使用的ImapFlow v1.0.98版本较旧，Microsoft 365的IMAP服务对命令格式、参数处理有特定要求，旧版本的ImapFlow在构造LSUB请求时可能不符合服务端规范，导致请求被拒绝。

• IMAP连接配置错误
  你的代码中ImapFlow构造函数的参数结构有误：用户凭证（user和pass）被作为第二个独立参数传入，而正确的做法是将其放在顶层配置对象内。这种错误会导致认证信息未正确加载，部分依赖基础认证的操作（如发邮件、打开单封邮件）可能侥幸运行，但列表邮箱这类需要完整权限校验的命令会失败。

• 权限或特殊邮箱处理问题
  尽管其他客户端正常，但你的应用可能未申请足够的IMAP权限。需确认Azure AD应用已添加IMAP.AccessAsUser.All的Delegated权限，且完成用户授权或管理员同意。此外，若用户账户包含共享邮箱、归档邮箱等特殊文件夹，旧版本ImapFlow可能无法正确处理，触发LSUB命令失败。

• TLS配置不安全
  你设置了rejectUnauthorized: false跳过证书验证，虽然能建立连接，但Microsoft IMAP服务可能对敏感命令（如LSUB）拒绝不安全的连接，导致请求失败。

解决建议 #

1. 修复连接配置结构
   调整ImapFlow初始化代码，将用户凭证合并到顶层配置对象中：

   function getConnection() {
       const ipaddr = '';
       const port = '';
       const isSSL = true;
       const mail = '';
       const mailPass = '';
       return new Promise<any>((resolve, reject) => {
           let client = new ImapFlow(
               {
                   logger: true,
                   host: ipaddr,
                   port: port,
                   secure: isSSL,
                   tls: {
                       rejectUnauthorized: true // 恢复安全的证书验证
                   },
                   user: mail,
                   pass: mailPass
               }
           );
           client.connect().then(resolve).catch(reject); // 补充错误处理
       });
   }
   

2. 升级ImapFlow版本
   升级到最新稳定版，修复兼容性问题：

   npm update imapflow
   

3. 验证Azure AD权限
   确认Azure AD应用已配置IMAP.AccessAsUser.All权限（Delegated类型），并完成授权流程。

4. 替换邮箱列表方法
   尝试用imap.getMailboxes()替代imap.list()，该方法可能使用更兼容的LIST命令，避免LSUB的兼容性问题：

   const list = await imap.getMailboxes();
   

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