使用OAuth2通过IMAP协议连接Gmail失败的技术求助

核心错误原因分析 #

1. OAuth授权Scope完全错误
   你获取授权码时使用的是https://www.googleapis.com/auth/drive（Google Drive权限），但IMAP访问Gmail需要邮件相关权限Scope，错误的Scope导致生成的Access Token完全没有Gmail IMAP访问权限，直接被服务器拒绝。

2. 冗余的App Password传入
   XOAUTH2认证机制不需要App Password（App Password仅用于传统密码登录场景），你在store.connect中传入的App Password属于无效参数，可能干扰认证流程。

3. 旧Token无有效权限
   因之前授权流程使用错误Scope，已获取的Access Token和Refresh Token无法用于IMAP认证，必须重新生成。

解决方案 #

1. 修正OAuth授权Scope #

将获取授权码的链接中scope参数替换为以下任意一个（遵循最小权限原则）：

• 全邮件权限：https://mail.google.com/
• 仅IMAP访问权限：https://www.googleapis.com/auth/gmail.imap_access

修正后的授权链接示例：

https://accounts.google.com/o/oauth2/auth?client_id=你的ClientID&redirect_uri=http://localhost&response_type=code&scope=https://www.googleapis.com/auth/gmail.imap_access&access_type=offline

2. 重新生成Token #

通过修正后的链接重新获取授权码，再用该授权码生成新的Access Token和Refresh Token。

3. 修正IMAP连接代码 #

移除store.connect中的App Password，将密码参数改为空字符串：

// 原错误代码
// final String emptyPassword = "app passowrd";
// store.connect(host, port, userEmail, emptyPassword);

// 修改后代码
store.connect(host, port, userEmail, "");

4. 验证Token权限 #

调用Token信息接口确认新Token的Scope是否正确（替换YOUR_ACCESS_TOKEN为你的新Token）：

https://www.googleapis.com/oauth2/v3/tokeninfo?access_token=YOUR_ACCESS_TOKEN

返回结果中的scope字段需包含你指定的邮件相关权限。

额外检查点 #

• 确保Google Cloud项目已启用Gmail API（在控制台API库中搜索并启用）。
• 确认JavaMail版本支持XOAUTH2，推荐使用最新版的Jakarta Mail依赖（jakarta.mail:jakarta.mail-api + com.sun.mail:jakarta.mail）。

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