PHPMailer采用Google XOAUTH2连接成功但无法发送邮件问题求助

故障核心现象 #

从你提供的SMTP日志可以看出，SMTP连接建立、EHLO握手全程正常，服务器也明确返回支持XOAUTH2认证方式，但客户端没有发起任何认证、邮件内容传输的请求，就直接发送QUIT指令断开连接，问题出在XOAUTH2认证流程触发前的环节。

排查步骤 #

• 优先校验配置参数读取是否正常：代码中所有认证相关参数（mailUser、oauthClientID、oauthClientSecret、oauthRefreshToken）均从F3框架配置中读取，集成到应用后大概率出现配置加载异常，参数为空或与你单独测试时的有效值不一致。可在sendPHPMail函数开头将这几个参数写入日志，和测试环境参数做对比。尤其是refreshToken如果无效，PHPMailer的OAuth组件无法生成有效认证凭证，会直接终止流程。
• 检查依赖完整性：单独测试时composer依赖加载完整，集成到应用后可能出现league/oauth2-client、league/oauth2-google库缺失或版本不兼容的问题，导致OAuth实例初始化失败，直接跳过认证环节。
• 调高调试级别定位具体错误：你当前设置的SMTPDebug = SMTP::DEBUG_CONNECTION仅能输出连接相关日志，修改为SMTP::DEBUG_SERVER即可输出认证环节的详细错误信息，直接定位问题根因。
• 修复异常捕获逻辑：PHPMailer 6.x以上版本的专属异常类为PHPMailer\PHPMailer\Exception，你当前捕获的phpmailerException未导入命名空间，实际不存在，认证环节抛出的异常无法被捕获，也不会写入日志。可修改catch块直接捕获全局Exception，或先导入正确的PHPMailer异常类。

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