使用Jakarta Mail 2.0.1+OAuth2+SMTP+TLS1.2发Gmail遇认证失败

针对你遇到的jakarta.mail.AuthenticationFailedException: OAUTH2 asked for more错误，以下是具体排查点和解决方案：

1. 确认OAuth2令牌的有效性与权限 #

• 确保当前使用的access token未过期：调用Google令牌刷新端点，用refresh token获取最新的access token后重试。
• 验证令牌权限范围：检查获取token时请求的scope是否包含https://www.googleapis.com/auth/gmail.send或https://mail.google.com/——控制台配置的scope必须和代码中请求的完全一致，否则令牌会缺少SMTP发送权限。
• 测试用户配置：在Google Cloud Console的OAuth consent screen中，确认你的测试邮箱（me@gmail.com）已添加到测试用户列表，否则测试模式下无法正常使用权限。

2. 修正SMTP属性配置 #

确保以下核心属性设置正确，这是触发XOAUTH2认证的关键：

Properties smtpProps = new Properties();
smtpProps.put("mail.smtp.host", "smtp.gmail.com");
smtpProps.put("mail.smtp.port", "587");
smtpProps.put("mail.smtp.auth", "true");
smtpProps.put("mail.smtp.starttls.enable", "true");
// 启用SASL并指定XOAUTH2机制
smtpProps.put("mail.smtp.sasl.enable", "true");
smtpProps.put("mail.smtp.sasl.mechanisms", "XOAUTH2");
// 禁用其他认证机制
smtpProps.put("mail.smtp.auth.login.disable", "true");
smtpProps.put("mail.smtp.auth.plain.disable", "true");
// 指定授权ID为用户邮箱
smtpProps.put("mail.smtp.sasl.authorizationid", "me@gmail.com");

3. 正确的SMTP连接方式 #

Jakarta Mail 2.0.1中，直接使用SMTPTransport传入access token是最可靠的方式，无需对token做Base64编码（框架会自动处理）：

Session session = Session.getInstance(smtpProps);
// 构建邮件内容
MimeMessage message = new MimeMessage(session);
message.setFrom(new InternetAddress("me@gmail.com"));
message.addRecipient(Message.RecipientType.TO, new InternetAddress("recipient@example.com"));
message.setSubject("测试邮件");
message.setText("这是通过OAuth2 SMTP发送的测试邮件");

// 建立SMTP连接并发送
try (SMTPTransport transport = (SMTPTransport) session.getTransport("smtp")) {
    transport.connect("smtp.gmail.com", "me@gmail.com", accessToken);
    transport.sendMessage(message, message.getAllRecipients());
}

4. 排查Java环境SASL支持 #

部分Java环境可能默认未启用XOAUTH2 SASL机制，可通过添加JVM参数强制启用：

-Dmail.smtp.sasl.mechanisms=XOAUTH2
-Dmail.smtp.sasl.enable=true

如果问题仍存在，可开启Jakarta Mail调试日志排查详细交互：

session.setDebug(true);

日志会输出SMTP对话细节，帮助定位令牌是否被正确传递、服务器返回的具体错误信息。

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