MAMP升级至6.4版本后本地PHPMailer运行报错SMTP connect()失败

第一步：开启PHPMailer调试输出确认具体错误 #

• 在你的PHPMailer初始化代码后添加调试配置，获取更详细的错误信息：

$mail->SMTPDebug = 3; // 输出完整的SMTP连接调试日志
$mail->Debugoutput = function($str, $level) {
    file_put_contents(__DIR__.'/smtp_debug.log', date('Y-m-d H:i:s').' '.$str."\n", FILE_APPEND);
};

• 运行发信代码后查看生成的smtp_debug.log文件，确认是端口拦截、证书验证失败还是PHP扩展缺失导致的连接问题。

第二步：排查MAMP PHP配置异常 #

MAMP升级后会自动重置自定义的php.ini配置，是此类问题的高发原因：

• 确认必要扩展已开启：
  1. 打开MAMP控制面板，进入「Preferences」→「PHP」，确认当前使用的PHP版本
  2. 点击对应版本旁的「php.ini」按钮打开配置文件，搜索extension=openssl、extension=sockets，确保配置项前没有分号注释，修改完成后重启MAMP服务
• 排查强制邮件配置：在php.ini中搜索SMTP、smtp_port、sendmail_path三项，确认没有被写死为无效值，如果不需要本地sendmail服务可以直接注释这三项，让PHPMailer自行处理SMTP连接逻辑。

第三步：排查端口与SSL证书验证问题 #

MAMP 6.4默认开启了严格的PHP SSL证书校验规则，是升级后SMTP连接失败的常见诱因：

• 先测试SMTP端口连通性：打开MAMP内置终端（不要使用系统自带终端，避免PHP环境、权限不一致），执行对应SMTP服务的端口测试命令，比如QQ邮箱SMTP测试命令为telnet smtp.qq.com 465，如果连接失败，需在系统「设置」→「隐私与安全性」→「防火墙」中放行MAMP的所有网络权限
• 修复SSL证书验证问题：
  1. 临时测试可在PHPMailer配置中添加关闭验证的参数（仅本地测试使用，禁止在线上环境配置）：

  $mail->SMTPOptions = array(
      'ssl' => array(
          'verify_peer' => false,
          'verify_peer_name' => false,
          'allow_self_signed' => true
      )
  );
  

  2. 永久修复：下载CA根证书文件到本地磁盘，打开php.ini找到openssl.cafile配置项，填写证书文件的绝对路径，保存后重启MAMP即可。

第四步：特殊场景修复 #

• 如果调试日志显示为IPv6连接失败，可打开系统/etc/hosts文件，添加你的SMTP域名的IPv4解析记录，强制走IPv4连接
• 如果你使用25端口发信，需确认本地运营商没有拦截25端口，可更换为465（SSL）或587（TLS）端口测试。

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