PHPMailer无法发送邮件：SMTP配置问题排查求助

一、Gmail SMTP 认证核心问题 #

Gmail 目前已不再支持使用普通账号密码进行SMTP认证，必须满足以下条件：

• 开启两步验证：Google账号必须开启两步验证，否则无法生成应用专用密码。
• 使用应用专用密码：替换代码中的$mail->Password = 'XXXXXXXXXXXXXXXX';为你生成的16位应用专用密码，而非账号登录密码。
• 注意：未开启两步验证时，即使输入正确密码也会被Google拒绝访问。

二、代码中的调试与错误信息缺失 #

你的sendmail函数捕获异常后仅返回false，没有记录具体错误，导致无法定位问题。修改异常处理逻辑，添加错误日志或返回详情：

catch (Exception $e) {
    // 写入错误日志便于排查
    error_log('邮件发送失败: ' . $mail->ErrorInfo);
    // 开发阶段可直接返回错误信息
    return 'Error: ' . $mail->ErrorInfo;
}

同时开启SMTP调试模式，在SMTP配置后添加：

$mail->SMTPDebug = 2; // 显示详细的SMTP交互日志，定位连接/认证问题

三、SMTP配置细节检查 #

1. 发件人地址一致性：setFrom中的邮箱必须与Username完全一致，Gmail要求发件人需和SMTP认证账号匹配，否则会被拦截。
2. 端口与加密匹配：端口587对应SMTPSecure = 'tls'，端口465对应SMTPSecure = 'ssl'，若服务器封禁587端口，可尝试切换到465端口。
3. 启用自动TLS：添加$mail->SMTPAutoTLS = true;，确保自动启用TLS加密，避免手动配置疏漏。

四、邮件内容与投递优化 #

1. 添加纯文本替代内容：仅发送HTML邮件易被判定为垃圾邮件，补充纯文本版本：

$mail->AltBody = "你的验证码是：{$verificationCode}\n感谢注册！";

2. 检查收件人邮箱：确认测试收件人未将发件人加入黑名单，同时查看垃圾邮件文件夹。

五、服务器环境限制 #

• PHP扩展支持：确保服务器安装并启用openssl扩展，PHPMailer的TLS/SSL加密依赖该扩展，可通过phpinfo()查看状态。
• 端口封禁检查：联系主机商确认服务器出站端口587/465未被封禁，部分云服务商默认限制这类端口。

六、PHPMailer版本问题 #

使用旧版PHPMailer可能存在Gmail协议兼容问题，建议通过Composer安装最新版本：

composer require phpmailer/phpmailer

然后使用自动加载替代手动引入文件：

require 'vendor/autoload.php';

内容的提问来源于stack exchange，提问作者Mark nicholas Razon