如何强制Java Mail使用XOAUTH2而非PLAIN认证机制？

我尝试使用Java Mail通过XOAUTH2连接IMAP服务器，配置代码如下：

Properties properties= new Properties();
properties.put("mail.imap.ssl.enable", "true");
properties.put("mail.imap.auth.mechanisms", "XOAUTH2");
properties.put("mail.imap.auth.login.disable", true);
properties.put("mail.imap.auth.plain.disable", true);
properties.put("mail.imap.auth.xoauth2.disable", false);
properties.put("mail.debug", "true");
properties.put("mail.debug.auth", "true");
                
Session session = Session.getInstance(properties);
store = session.getStore("imaps");
store.connect(host, username, accessToken);

我已设置所有属性以限制仅使用XOAUTH2认证机制，但调试信息显示实际使用的是AUTHENTICATE PLAIN而非AUTHENTICATE XOAUTH2。

POM中使用的依赖：

<dependency>
    <groupId>com.sun.mail</groupId>
    <artifactId>javax.mail</artifactId>
    <version>1.6.2</version>
</dependency>

另外，我通过openssl直接执行AUTHENTICATE XOAUTH2命令可以完成认证。

请问我哪里操作有误？如何让Java Mail使用AUTHENTICATE XOAUTH2命令而非AUTHENTICATE PLAIN？

问题排查与解决方法： #

1. 属性前缀与协议不匹配
   你使用的是imaps协议（SSL加密IMAP），但配置的是mail.imap.*前缀的属性，这类属性仅对普通IMAP协议生效，对imaps协议无作用。需将属性前缀改为mail.imaps.*：

   properties.put("mail.imaps.auth.mechanisms", "XOAUTH2");
   properties.put("mail.imaps.auth.login.disable", true);
   properties.put("mail.imaps.auth.plain.disable", true);
   properties.put("mail.imaps.auth.xoauth2.disable", false);
   

   修正后，配置会对imaps连接生效，避免程序 fallback 到PLAIN认证。

2. 升级依赖版本
   Java Mail 1.6.2版本对XOAUTH2的支持存在兼容性问题，建议升级到最新的Jakarta Mail版本（原Java Mail已迁移至Jakarta EE体系）：

   <dependency>
       <groupId>com.sun.mail</groupId>
       <artifactId>jakarta.mail</artifactId>
       <version>2.0.1</version>
   </dependency>
   

   注意升级后需将代码中的javax.mail包导入替换为jakarta.mail。

3. 验证令牌与连接方式
   确保accessToken是符合XOAUTH2格式的有效令牌，username为对应邮箱地址。也可尝试显式传入认证参数的连接方法：

   store.connect(host, new PasswordAuthentication(username, accessToken));
   

修改完成后开启调试模式重新测试，即可看到AUTHENTICATE XOAUTH2的请求日志。

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