使用PHP OAuth库调用Google服务时权限范围及SMTP连接问题求助

我之前在做PHP项目集成Google OAuth和PHPMailer时，刚好踩过一模一样的坑，给你梳理下问题根源和可行的解决办法：

一、权限范围的问题处理 #

Google早就废弃了mail.google.com这个权限范围，现在所有Gmail相关的OAuth权限都必须使用官方指定的标准范围，比如：

• 发送邮件：https://www.googleapis.com/auth/gmail.send
• 只读访问邮件：https://www.googleapis.com/auth/gmail.readonly

但光用对范围还不够，还要注意两个关键点：

• 必须在Google Cloud控制台的OAuth同意屏幕中，把这些权限范围添加到已授权的范围列表里；
• 如果你的应用是面向外部用户的（非内部测试），必须完成Google的应用验证流程，否则Google会限制这些敏感权限的使用，导致权限无法正常生效。

二、SMTP 535认证失败的解决办法 #

出现QUIT命令执行失败: 535-5.7.8 用户名和密码不被接受这个错误，核心原因是现在Google不再允许用普通的账号密码登录SMTP，必须改用OAuth2认证。你需要在PHPMailer中正确配置OAuth参数：

首先确保你的代码里开启了正确的SMTP设置：

$mail = new PHPMailer(true);
try {
    // SMTP基础配置
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->Port = 587;
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    
    // 关键：启用OAuth2认证模式
    $mail->SMTPAuth = true;
    $mail->AuthType = 'XOAUTH2';
    
    // OAuth核心参数配置
    $mail->oauthUserEmail = 'your-account@gmail.com';
    $mail->oauthClientId = '你的Google Cloud客户端ID';
    $mail->oauthClientSecret = '你的Google Cloud客户端密钥';
    $mail->oauthRefreshToken = '已获取的有效刷新令牌';
    
    // 邮件内容配置
    $mail->setFrom('sender@example.com', 'Sender Name');
    $mail->addAddress('recipient@example.com', 'Recipient Name');
    $mail->Subject = 'Test Email via OAuth2';
    $mail->Body = 'This is a test email sent with PHPMailer and Google OAuth2';
    
    $mail->send();
    echo 'Message has been sent successfully';
} catch (Exception $e) {
    echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}

另外还要检查这几个细节：

• 确认你的Google Cloud项目已经启用了Gmail API（在API库中搜索并启用）；
• 刷新令牌是否有效：如果令牌过期、被撤销，或者你的账号密码修改过，都需要重新生成刷新令牌；
• 不要尝试开启“不太安全的应用访问”，Google已经彻底关闭了这个选项，必须用OAuth2认证。

额外排查小贴士 #

如果还是有问题，可以从这几个方向排查：

• 查看Google Cloud的API控制台日志，里面会记录具体的权限拒绝或认证失败原因；
• 确认刷新令牌是用正确的权限范围生成的，生成令牌时必须包含你需要的Gmail权限；
• 测试时先用内部测试账号（OAuth同意屏幕中添加的测试用户），避免外部验证未通过导致的权限限制。

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