Bluehost主机CPanel部署Yii2应用无法发送邮件求助

问题背景 #

我开发了一个Yii2应用并部署在Bluehost的CPanel中，在CPanel创建了邮箱账号，通过SwiftMailer发送邮件。该配置在本地环境可正常发送，但部署到CPanel后，虽然返回结果为true且日志无报错，却无法实际发送邮件。尝试过更新SPF记录、更换端口（25/465）及加密方式（SSL）均无效，更换发件邮箱为user@workdomain.co并将主机改为outlook.office365.com则可正常发送。项目发件域为子域名api.mydomainname.com，该域名与应用同服务器。当前邮件配置如下：

'mailer' => [
    'class' => 'yii\swiftmailer\Mailer',
    'viewPath' => '@common/mail',
    'useFileTransport' => false,
    'transport' => [
        'class' => 'Swift_SmtpTransport',
        //'host' => 'smtp.office365.com',
        'host' => 'mail.mydomainname.com',
        'port' => '587',
        'username' => 'noreply@mydomainname.com',
        'password' => 'pass',
        'encryption' => 'tls',
        'streamOptions' => [ 
            'ssl' => [ 
                'allow_self_signed' => true,
                'verify_peer' => false,
                'verify_peer_name' => false,
            ],
        ]
    ],         
]

解决方案 #

1. 改用Bluehost官方SMTP主机 #

Bluehost对自建SMTP有出站限制，直接用官方提供的smtp.bluehost.com作为主机，比自己的mail.mydomainname.com更稳定，配置调整如下：

'transport' => [
    'class' => 'Swift_SmtpTransport',
    'host' => 'smtp.bluehost.com',
    'port' => 465,
    'username' => 'noreply@mydomainname.com',
    'password' => 'your_actual_password',
    'encryption' => 'ssl',
    // 删除streamOptions，官方SMTP有正规证书，无需关闭验证
],

2. 对齐发件人域名与SPF记录 #

你的发件域是api.mydomainname.com，但发件邮箱是noreply@mydomainname.com，部分邮件系统会校验域名归属：

• 要么在CPanel创建noreply@api.mydomainname.com邮箱，改用这个地址发件
• 要么更新mydomainname.com的SPF记录，加入api.mydomainname.com的IP，比如设置为：
  v=spf1 a mx include:api.mydomainname.com ~all

3. 查看服务器邮件追踪日志 #

Yii返回true不代表邮件成功投递，登录CPanel的邮件账户 -> 追踪交付，查看邮件的实际状态，是否被标记为垃圾邮件、被拦截或进入队列。也可以查看服务器的/var/log/maillog日志（CPanel后台也能找到错误日志入口），找到具体的投递失败原因。

4. 切换到Sendmail传输（备选方案） #

如果SMTP始终无法正常工作，直接调用服务器本地的sendmail命令，避免SMTP连接问题：

'transport' => [
    'class' => 'Swift_SendmailTransport',
    'command' => '/usr/sbin/sendmail -t',
],

这种方式不需要配置SMTP主机和端口，直接用Bluehost的本地邮件服务，兼容性更好。

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