JavaMail使用Gmail OAuth发信要求全量mail scope的问题咨询

你遇到的Oauth asks for more报错并非https://www.googleapis.com/auth/gmail.send这个窄scope无法支持发信，而是JavaMail的SMTP OAuth2认证配置不完善导致的权限校验不通过。

• 首先升级JavaMail依赖到1.5.5及以上版本，低版本存在窄scope OAuth2兼容bug。
• 调整JavaMail会话属性配置，显式指定XOAuth2认证机制，避免默认走高权限要求的认证逻辑，示例配置如下：

Properties props = new Properties();
// 开启SMTP认证
props.put("mail.smtp.auth", "true");
// 强制使用XOAuth2认证机制
props.put("mail.smtp.auth.mechanisms", "XOAUTH2");
// 开启TLS加密
props.put("mail.smtp.starttls.enable", "true");
props.put("mail.smtp.host", "smtp.gmail.com");
props.put("mail.smtp.port", "587");

• 连接逻辑保持原有逻辑即可，注意使用的access token必须是通过https://www.googleapis.com/auth/gmail.send这个scope授权获取的，不能复用之前全量scope生成的token：

Session session = Session.getInstance(props);
try (Transport transport = session.getTransport("smtp")) {
    transport.connect("smtp.gmail.com", 587, "你的邮箱地址@gmail.com", accessToken);
    // 后续发信逻辑保持不变
}

• 额外校验规则：确保GCP控制台对应项目的OAuth同意屏幕配置中，已经添加了https://www.googleapis.com/auth/gmail.send scope，如果应用处于测试状态，需要将发信邮箱加入到测试用户列表中。

按照上述配置操作后，即可仅使用发信窄权限完成JavaMail的Gmail发信需求，无需申请全量邮箱操作权限。

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