线上环境PHPMailer重置密码功能SMTP连接失败求助

错误信息 #

[12-May-2023 17:53:32 UTC] PHP Fatal error: Uncaught PHPMailer\PHPMailer\Exception: SMTP Error: Could not connect to SMTP host. in /home/raso1970/cliquedigitalepdo.com4muz.com/vendor/phpmailer/phpmailer/src/PHPMailer.php:2233
Stack trace:
#0 /home/raso1970/cliquedigitalepdo.com4muz.com/vendor/phpmailer/phpmailer/src/PHPMailer.php(2019): PHPMailer\PHPMailer\PHPMailer->smtpConnect()
#1 /home/raso1970/cliquedigitalepdo.com4muz.com/vendor/phpmailer/phpmailer/src/PHPMailer.php(1678): PHPMailer\PHPMailer\PHPMailer->smtpSend()
#2 /home/raso1970/cliquedigitalepdo.com4muz.com/vendor/phpmailer/phpmailer/src/PHPMailer.php(1516): PHPMailer\PHPMailer\PHPMailer->postSend()
#3 /home/raso1970/cliquedigitalepdo.com4muz.com/forgot.php(75): PHPMailer\PHPMailer\PHPMailer->send()
#4 {main}
thrown in /home/raso1970/cliquedigitalepdo.com4muz.com/vendor/phpmailer/phpmailer/src/PHPMailer.php on line 2233

已知情况 #

• 本地环境用相同代码可正常运行
• 同服务器下的contact.php使用完全一致的SMTP配置能正常发邮件
• 本地和线上PHP版本均为8.2
• 尝试注释use PHPMailer\PHPMailer\SMTP;和use PHPMailer\PHPMailer\Exception;后问题未解决

解决方案 #

1. 修正PHPMailer配置错误 #

你的forgot.php中存在明显的SMTP配置参数错误：

// 错误写法
$mail->SMTPAuth   = 'ssl';

SMTPAuth是控制是否启用SMTP身份验证的布尔值（true/false），不是加密方式。加密方式由SMTPSecure控制，将其改为：

// 正确写法
$mail->SMTPAuth = true;

这是导致线上连接失败的核心原因。

2. 验证配置常量一致性 #

虽然contact.php可用，但仍需确认forgot.php中调用的配置常量是否正确加载。在初始化PHPMailer前添加调试代码：

var_dump(Config::SMTP_HOST, Config::SMTP_USER, Config::SMTP_PORT);
exit;

确保输出的值和contact.php中使用的完全一致。

3. 开启PHPMailer调试模式排查细节 #

添加调试模式，获取SMTP连接的详细日志，定位具体失败原因：

$mail = new PHPMailer(true);
$mail->SMTPDebug = SMTP::DEBUG_SERVER; // 开启详细调试输出

调试信息会显示DNS解析、握手、身份验证等全过程，帮助你快速定位问题。

4. 检查服务器防火墙/安全组规则 #

确认线上服务器的出站规则是否允许访问SMTP服务器的对应端口（如465对应SMTPS，587对应STARTTLS）。部分主机商会限制出站邮件端口，即使同服务器下其他脚本可用，也可能存在执行环境的规则差异。

5. 确认PHP扩展加载状态 #

线上环境检查openssl扩展是否正常加载（PHPMailer的SMTP加密依赖该扩展）：

var_dump(extension_loaded('openssl'));

若返回false，需在php.ini中启用openssl扩展。

内容的提问来源于stack exchange，提问作者Sofiane Abou Abderrahim