使用php-imap2+OAuth2连接Gmail失败，凭证验证不通过求助

核心问题：Access Token权限范围不足 #

从你提供的tokeninfo返回结果能看到，当前Access Token的Scope仅包含用户信息相关权限：

{
  "scope": "https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/userinfo.profile openid"
}

而Gmail IMAP服务要求必须包含邮件访问类Scope，服务器返回的Base64错误信息（eyJzdGF0dXMiOiI0MDAiLCJzY2hlbWVzIjoiQmVhcmVyIiwic2NvcGUiOiJodHRwczovL21haWwuZ29vZ2xlLmNvbS8ifQ==）解码后明确指出需要https://mail.google.com/权限：

{"status":"400","schemes":"Bearer","scope":"https://mail.google.com/"}

解决步骤 #

1. 更新OAuth授权Scope
   在获取Access Token的授权流程中，添加以下任一Scope：

   • https://mail.google.com/：完整的Gmail邮件访问权限（推荐）
   • https://www.googleapis.com/auth/gmail.imap_access：仅IMAP访问权限

2. 重新获取Access Token
   旧的Access Token权限已固定，必须引导用户重新完成OAuth授权流程，获取包含正确Scope的新Token。

3. 验证新Token的Scope
   再次调用https://www.googleapis.com/oauth2/v1/tokeninfo?access_token=新Token，确认返回的scope字段包含上述邮件权限。

额外调试方法 #

• 解码服务器返回的错误信息：Gmail IMAP返回的+后面的Base64字符串可直接解码，里面会包含明确的权限要求或错误原因。
• 检查OAuth客户端配置：确保Google Cloud控制台中你的OAuth客户端类型与应用场景匹配（如服务器端应用选「Web应用」或「桌面应用」），重定向URI配置正确。
• 启用更详细的调试日志：php-imap2的调试模式可输出完整的IMAP交互内容，帮助排查协议层面的问题。

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