配置DKIM的服务器中symfony/mailer无法发邮件但native mail正常

一、排查native://default静默失败的原因 #

• 开启邮件调试日志定位问题，在Yii2配置文件中添加日志规则：

  'log' => [
      'targets' => [
          [
              'class' => 'yii\log\FileTarget',
              'categories' => ['symfony\mailer\*'],
              'logFile' => '@runtime/logs/mailer.log',
              'levels' => ['error', 'warning'],
          ],
      ],
  ],
  

  发送测试邮件后查看日志文件，即可获取静默失败的具体触发原因，比如sendmail路径错误、权限不足等。
• 手动指定sendmail路径，部分系统sendmail默认路径可能与symfony预设不符，在邮件组件配置中明确配置：

  'mailer' => [
      'class' => 'yii\symfonymailer\Mailer',
      'transport' => [
          'dsn' => 'native://default?command=/usr/sbin/sendmail -t -i',
      ],
  ],
  

  可通过服务器命令which sendmail获取实际路径，替换上述配置中的/usr/sbin/sendmail。

二、修复SmtpTransport的550错误 #

该错误属于发件人验证失败，可从以下方向解决：

• 确保发件人邮箱域名与服务器DKIM配置的域名完全一致，且发件人地址为真实存在、可路由的有效邮箱。
• 检查SMTP传输配置的发件人参数，避免使用空值或无效地址：

  'mailer' => [
      'class' => 'yii\symfonymailer\Mailer',
      'transport' => [
          'class' => 'Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport',
          'host' => 'localhost', // 或你的本地SMTP服务器地址
          'port' => 25,
          'username' => 'valid-sender@your-domain.com',
          'password' => 'your-smtp-password', // 若SMTP需认证则填写
          'localDomain' => 'your-domain.com', // 需与DKIM配置域名一致
      ],
      'messageConfig' => [
          'from' => ['valid-sender@your-domain.com' => 'Sender Name'],
      ],
  ],
  

• 临时关闭SMTP发件人验证（仅用于排查，不推荐长期使用）：若使用本地Postfix等SMTP服务，可修改配置关闭smtpd_sender_restrictions中的验证规则，确认是否为验证逻辑导致的问题。

三、其他排查方向 #

• 检查服务器SELinux或防火墙规则，确认是否存在拦截PHP调用sendmail或SMTP端口的限制。
• 对比原生mail函数与symfony mailer的邮件格式，确保symfony配置中的发件人、收件人地址无格式错误（如含空格、特殊字符）。

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