CakePHP 2向Gmail发信被拦截（错误550-5.7.26）排查求助

问题现状 #

• 框架环境：CakePHP 2，使用自有域名SMTP服务向Gmail地址发信被拦截，Gmail返回错误：

550-5.7.26 This message does not have authentication information or fails to

• 已知前提：发信域名已配置SPF记录，使用Thunderbird等邮件客户端配置相同SMTP账号可以正常向Gmail发信。
• 原有配置与代码存在明显缺陷：
  1. /app/Config/email.php初始配置未开启TLS加密

class EmailConfig {

public $email = array(
'transport' => 'Smtp',
'host' => 'mail.example.com',
'port' => 587,
'timeout' => 30,
'username' => 'example@example.com',
'password' => 'password',
'log' => false,
'returnPath' => 'example@example.com',
);

}

2. 自行修改的配置存在语法缺失、字段错误，且配置节点与实际调用不匹配
```php
class EmailConfig {

public $email = array(
      'transport' => 'Smtp',
      'host' => 'mail.example.com',
      'port' => 587,
      'timeout' => 30,
      'username' => 'example@example.com',
      'password' => 'password',
      'log' => false,
      'SMTPSecure' => 'starttls',
      'tls' => true,
      'context'=>array('ssl' => array(
      'verify_peer' => false,
      'verify_peer_name' => false,
      'allow_self_signed' => true

3. 控制器发信逻辑调用的配置节点不存在

$email = new CakeEmail('ap');

          $email->charset = 'ISO-2022-JP';

          $result = $email

          ->config(array('log' => 'emails'))

          ->to(array($this->request->data['Order']['mail']))

          ->bcc(array(Configure::read ('Mail.Bcc')))
          ->from(array(Configure::read ('Mail.FromMail')=> 'MyBusinessName'))
          ->subject($this->request->data['Order']['order_subject'])
          ->send($this->request->data['Order']['message']);

          if (!$result) {
              $this->Session->setFlash(__('MailSend Failed Retry Again '));
              return;
          } else {

              $this->OrderMailHistory->commit();
              $this->OrderStateHistory->commit();
              $this->Order->commit();

              $this->redirect(array('action' => 'detail/', $this->request->data['Order']['id']));

          }

      }

核心问题定位 #

1. 配置节点不匹配：控制器实例化CakeEmail时传入的配置名是ap，但EmailConfig类中只定义了$email节点，所有修改的TLS配置完全没有生效，程序实际走的是明文未加密SMTP传输，未完成SASL认证，直接触发Gmail的拦截规则。
2. 配置语法错误：修改后的配置缺少数组、类结构的闭合括号，且SMTPSecure是PHPMailer的配置字段，CakePHP 2中不需要该字段，错误的SSL上下文参数关闭了证书校验，会被Gmail判定为不安全传输。
3. 身份校验配置不全：当前仅配置SPF不符合Gmail现行发信要求，必须搭配DKIM签名、DMARC记录才能通过身份校验。
4. 发信头配置不规范：仅单独设置了正文编码，未设置邮件头编码，日文ISO-2022-JP编码下容易出现头信息乱码，导致SPF/DKIM校验失效。

修复步骤 #

1. 修正EmailConfig配置 #

直接定义和调用名匹配的$ap配置节点，补全正确的TLS、编码配置，移除不安全的证书校验关闭参数：

class EmailConfig {
    public $ap = array(
        'transport' => 'Smtp',
        'host' => 'mail.example.com',
        'port' => 587,
        'timeout' => 30,
        'username' => 'example@example.com',
        'password' => 'password',
        'log' => true, // 开启邮件日志，方便排查交互问题
        'returnPath' => 'example@example.com', // 必须和发信地址、SMTP认证账号完全一致
        'tls' => true, // CakePHP 2中开启587端口的STARTTLS仅需设置该参数
        'charset' => 'ISO-2022-JP',
        'headerCharset' => 'ISO-2022-JP', // 单独设置邮件头编码，避免头乱码
    );
}

2. 简化控制器发信逻辑 #

移除冗余的配置覆盖，增加发信地址一致性校验：

$email = new CakeEmail('ap');
$fromMail = Configure::read('Mail.FromMail');
// 强制校验发信地址和SMTP认证账号一致，避免域名不匹配导致SPF失败
if ($fromMail !== 'example@example.com') {
    throw new InternalErrorException('发信地址与SMTP账号不匹配');
}

$result = $email
    ->to($this->request->data['Order']['mail'])
    ->bcc(Configure::read('Mail.Bcc'))
    ->from(array($fromMail => 'MyBusinessName'))
    ->subject($this->request->data['Order']['order_subject'])
    ->send($this->request->data['Order']['message']);

if (!$result) {
    $this->Session->setFlash(__('MailSend Failed Retry Again '));
    return;
}

$this->OrderMailHistory->commit();
$this->OrderStateHistory->commit();
$this->Order->commit();
$this->redirect(array('action' => 'detail/', $this->request->data['Order']['id']));

3. 补全域名DNS身份记录 #

• 联系你的邮件服务商获取DKIM公钥，在域名DNS中添加对应的TXT记录，确保所有从该域名发出的邮件都带DKIM签名。
• 添加DMARC记录：主机记录为_dmarc，记录类型为TXT，记录值设置为v=DMARC1; p=none; rua=mailto:你的管理员邮箱，配置完成后等待DNS生效即可。

4. 验证点 #

• 查看邮件日志，确认SMTP交互过程中成功完成STARTTLS握手、AUTH LOGIN认证成功，和Thunderbird客户端的交互逻辑一致。
• 发测试信到Gmail，点开邮件原文查看Authentication-Results头，确认SPF、DKIM结果均为PASS，即可正常投递，不会再触发550-5.7.26拦截。

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