开启PHP邮件Content-Type HTML头后无法发送外部地址

可能原因及对应修复步骤 #

• 邮件头格式不规范
  外部邮箱（尤其是Gmail这类严格的服务商）对HTML邮件的头格式要求远高于纯文本，手动拼接的Content-Type行可能存在换行符、空格或格式错误，导致邮件被直接拦截。
  修复：

  1. 确保所有邮件头统一用\r\n换行，且头部末尾不要加多余空行；
  2. 检查$headers初始值的格式，比如发件人信息必须完整，冒号后加空格：

  $headers = "From: Your Name <your@domain.com>\r\n";
  $headers .= "Reply-To: your@domain.com\r\n";
  $headers .= "Content-Type: text/html; charset=UTF-8\r\n"; // 无多余空格或字符
  

• SPF/DKIM/DMARC配置缺失
  HTML邮件更容易触发反垃圾邮件规则，若域名未配置SPF/DKIM记录，外部邮箱会直接拒收邮件（甚至不生成拦截日志）。
  修复：

  1. 登录WHM面板，进入Email->Authentication，为对应域名启用SPF和DKIM；
  2. 检查DNS记录：SPF需包含服务器IP，DKIM公钥需正确解析；
  3. 先将DMARC记录设为p=none测试，确认邮件正常后再调整严格度。

• Exim隐性过滤规则
  虽然Exim主日志无记录，但可能存在针对HTML内容的自定义过滤规则，或MIME解析模块异常。
  修复：

  1. 进入WHM的Service Configuration->Exim Configuration Manager，检查Filters标签下是否有拦截HTML邮件的规则；
  2. 临时调高Exim日志级别：编辑配置文件添加log_selector = +all，重新发送测试邮件后查看详细日志；
  3. 确认Exim的MIME配置支持HTML格式解析。

• PHP mail()函数的环境差异
  PHP5.6和7.4的mail()函数处理头部编码的逻辑有细微差异，手动拼接易出错。
  修复：

  1. 用mb_encode_mimeheader()处理含特殊字符的发件人名称：

  $fromName = mb_encode_mimeheader("你的名称", "UTF-8", "B");
  $headers = "From: $fromName <your@domain.com>\r\n";
  

  2. 替换为PHPMailer类，自动处理格式和编码，还能输出具体错误：

  require 'PHPMailer/PHPMailer.php';
  require 'PHPMailer/SMTP.php';
  
  $mail = new PHPMailer\PHPMailer\PHPMailer();
  $mail->isSMTP();
  $mail->Host = 'localhost';
  $mail->SMTPAuth = false;
  $mail->Port = 25;
  
  $mail->setFrom('your@domain.com', 'Your Name');
  $mail->addAddress('recipient@gmail.com');
  
  $mail->isHTML(true);
  $mail->Subject = 'Test HTML Email';
  $mail->Body = '<h1>Hello World</h1>';
  $mail->CharSet = 'UTF-8';
  
  if(!$mail->send()) {
      echo 'Error: ' . $mail->ErrorInfo; // 直接获取具体失败原因
  } else {
      echo 'Email sent successfully';
  }
  

快速排查技巧 #

• 先发送极简HTML内容（比如仅<h1>Test</h1>），排除内容本身的问题；
• 检查服务器IP是否在邮件黑名单中（通过WHM的Mail Queue Manager或内置工具确认）；
• 换用Outlook、Yahoo等其他外部邮箱测试，缩小问题范围。

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