使用PHPMailer+XOAuth2时SMTP认证失败问题求助

以下是针对你遇到的“SMTP: Could not Authenticate”错误的具体排查和解决步骤：

1. 验证谷歌API权限与配置 #

• 启用Gmail API：登录谷歌云控制台，确认你的项目已启用Gmail API，未启用则搜索“Gmail API”并点击启用。
• OAuth consent screen配置：
  • 测试阶段需将发送邮件的邮箱（$payload->from_email）添加为测试用户。
  • 发布状态为“内部”时，确保该邮箱属于同一谷歌工作区；“外部”状态需完成审核（测试阶段无需审核，但仅限添加的测试用户）。
• OAuth权限范围：获取refresh token时必须申请https://mail.google.com/完整权限，仅https://www.googleapis.com/auth/gmail.send可能存在权限限制，导致认证失败。

2. 检查Refresh Token有效性 #

Refresh Token可能因以下情况失效：

• 用户修改了谷歌账户密码。
• 用户撤销了应用的权限。
• 应用超过6个月未使用该refresh token（谷歌会自动失效长期未用的token）。
• 同一客户端ID下，refresh token数量超过50个的限制。
  解决方法：重新生成refresh token，确保使用正确的权限范围和对应web类型客户端的授权流程。

3. 核对PHPMailer与依赖库版本 #

• 确保使用的PHPMailer版本支持XOAuth2，且依赖的league/oauth2-google库版本兼容，建议更新到最新稳定版：

  composer require phpmailer/phpmailer league/oauth2-google
  

4. 调整SMTP配置参数 #

你当前设置了SMTPAutoTLS = false，但587端口默认需要TLS协商，建议修改为：

$phpMailer->SMTPAutoTLS = true;

同时确认Host（smtp.gmail.com）和Port（587）配置正确。

5. 开启调试模式获取详细错误 #

添加调试代码，查看SMTP交互日志，定位具体失败原因：

$phpMailer->SMTPDebug = SMTP::DEBUG_SERVER; // 开启详细调试
$phpMailer->Debugoutput = function($str, $level) { echo "Debug level $level: $str<br>"; };

运行后查看输出，可确认是access token获取失败还是谷歌返回了权限类错误。

6. 简化OAuth配置代码 #

代码中重复传递clientId和clientSecret到OAuth实例和provider，可简化避免潜在冲突：

$oauth = new OAuth([
    'provider' => new Google([
        'clientId'     => $credentials['client_id'],
        'clientSecret' => $credentials['client_secret'],
    ]),
    'refreshToken' => $payload->refreshToken,
    'userName'     => $payload->from_email,
]);
$phpMailer->setOAuth($oauth);

7. 检查账户安全设置 #

• 若谷歌账户开启了“高级保护计划”，需将应用添加到信任列表，否则会限制OAuth访问。
• 确认未启用“不太安全的应用访问”（谷歌已弃用该功能，开启反而可能导致OAuth认证异常）。

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