localhost环境下PHPMailer发信报无法连接SMTP主机错误如何解决

PHPMailer 完全支持localhost本地环境正常运行，你遇到的「Could not connect to SMTP host」报错和本地运行环境无直接关系，由代码配置错误、网络限制、邮箱服务商规则不匹配导致。

• 加密配置与端口不匹配：你使用465端口连接Gmail SMTP，但注释掉了SMTPSecure加密配置。465是Gmail隐式TLS加密专属端口，不开启对应加密模式会直接被服务端断开连接。
• 类文件重复加载：你既手动引入了src/目录下的PHPMailer核心文件，又加载了Composer自动加载文件，存在类重复声明的冲突风险，两种加载方式二选一即可，使用Composer时无需手动引入src目录下的文件。
• 认证身份与发件人不匹配：SMTP认证环节填写的用户名是default@gmail.com，但setFrom设置的发件地址为其他Gmail账号，Gmail会直接拒绝身份不匹配的发件请求。
• 认证凭证不符合Gmail规则：Gmail已在2022年停止支持使用账号原始密码通过第三方客户端SMTP发信，你填写的普通登录密码无效，必须使用开启两步验证后生成的16位应用专用密码才能完成认证。

• 测试本地网络连通性：家用宽带、公司内网通常会默认封禁465/587/25等SMTP出站端口防止垃圾邮件滥发，可在命令行执行telnet smtp.gmail.com 465测试连通性，如果连接超时就是端口被封禁，更换网络或联系网络管理员放开端口即可。如果465端口不通，可尝试更换为587端口，搭配PHPMailer::ENCRYPTION_STARTTLS加密模式连接。
• 确认PHP扩展配置：连接加密SMTP服务必须开启PHP的openssl扩展，可通过phpinfo()查看扩展加载状态，未开启的话在php.ini中取消对应扩展的注释即可。
• 临时关闭本地防火墙、代理类软件测试，这类软件可能拦截PHP进程的出站SMTP连接。

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

// 仅保留Composer自动加载，删除手动引入src文件的代码
require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {
    $mail->SMTPDebug = SMTP::DEBUG_SERVER;
    $mail->isSMTP();
    $mail->Host       = 'smtp.gmail.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = '你的真实Gmail账号@gmail.com';
    $mail->Password   = 'Gmail后台生成的16位应用专用密码';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
    $mail->Port       = 465;
    $mail->CharSet    = 'UTF-8'; // 避免中文乱码

    // 发件地址必须和上方SMTP认证账号完全一致
    $mail->setFrom('你的真实Gmail账号@gmail.com', '发件人昵称');
    $mail->addAddress('收件人邮箱地址@domain.com', '收件人昵称');
    $mail->addReplyTo('接收回复的邮箱地址@domain.com', '回复标识');

    $mail->isHTML(true);
    $mail->Subject = '测试邮件标题';
    $mail->Body    = 'HTML格式邮件正文 <b>加粗测试内容</b>';
    $mail->AltBody = '纯文本格式邮件正文，供不支持HTML的邮箱客户端展示';

    $mail->send();
    echo '邮件发送成功';
} catch (Exception $e) {
    echo "邮件发送失败，错误信息：{$mail->ErrorInfo}";
}

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