Springboot+Camel-Mail应用IMAP认证后连接失败求助（Camel 3.20.6）

问题场景 #

使用Spring Boot + Apache Camel 3.20.6 + Camel-Mail开发应用，已确认OAuth2凭证有效，SMTP可正常发送邮件，但IMAP连接持续失败，报错如下：

A3 LIST "" INBOX
A3 BAD User is authenticated but not connected.
2024-09-16 20:49:16,795 WARN [Camel (camel) thread #1 - imaps://my-outlook.office365.com:my-port] org.apache.camel.spi.CamelLogger: Failed polling endpoint: imaps://my-outlook.office365.com:my-port?authenticator=%23exchangeAuthenticator&debugMode=true&delay=10000&delete=false&mail.imaps.auth.mechanisms=XOAUTH2&mail.imaps.proxy.host=10.XXX.YYY.6&mail.imaps.proxy.port=8**0&searchTerm=%23customSearch&unseen=true. Will try again at next poll. Caused by: [javax.mail.MessagingException - A3 BAD User is authenticated but not connected.]
javax.mail.MessagingException: A3 BAD User is authenticated but not connected.
    at com.sun.mail.imap.IMAPFolder.doCommand(IMAPFolder.java:3844)
    at com.sun.mail.imap.IMAPFolder.exists(IMAPFolder.java:566)
    at org.apache.camel.component.mail.MailConsumer.ensureIsConnected(MailConsumer.java:611)
    at org.apache.camel.component.mail.MailConsumer.poll(MailConsumer.java:128)
    at org.apache.camel.support.ScheduledPollConsumer.doRun(ScheduledPollConsumer.java:202)

排查与解决步骤 #

• 升级JavaMail版本：Camel 3.20.6默认依赖的JavaMail版本可能存在Office 365 IMAP协议兼容性问题，手动升级javax.mail:mail-api和com.sun.mail:javax.mail至1.6.2及以上版本，避免版本冲突。
• 修正代理配置：若使用代理，确保代理支持IMAPS透传，检查代理端口是否正确（日志中8**0疑似输入错误，应为8080）。同时添加mail.imaps.socks.host和mail.imaps.socks.port参数，替代仅HTTP代理的配置，适配IMAP协议的连接需求。
• 验证OAuth2权限范围：确认OAuth2令牌包含IMAP.AccessAsUser.All权限，Office 365的IMAP访问需单独配置该权限，SMTP权限无法覆盖IMAP。
• 补充IMAP端点关键参数：在Camel IMAP端点URL中添加以下参数：
  • mail.imaps.auth.plain.disable=true：强制禁用普通认证，确保仅使用XOAUTH2
  • mail.imaps.starttls.enable=true：启用TLS加密，符合Office 365的安全要求
  • mail.imaps.connectiontimeout=30000和mail.imaps.timeout=30000：延长连接超时时间，适配代理环境下的握手延迟
• 开启详细调试：通过系统属性mail.debug=true开启JavaMail全量调试，查看IMAP会话的完整命令交互，确认认证后到LIST命令之间的协议步骤是否存在异常。

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