Bluehost服务器Laravel应用跨域邮件投递失败问题求助

一、先排查Laravel邮件配置 #

• 确认.env中的邮件驱动：如果当前用的是mail（PHP原生函数），必须切换为Bluehost提供的SMTP配置——Bluehost对PHP mail函数的外部投递有默认限制，这是导致外部邮件静默失败的常见原因。配置示例：

  MAIL_MAILER=smtp
  MAIL_HOST=mail.your-addon-domain.com
  MAIL_PORT=465
  MAIL_USERNAME=your-email@your-addon-domain.com
  MAIL_PASSWORD=your-email-account-password
  MAIL_ENCRYPTION=ssl
  MAIL_FROM_ADDRESS=your-email@your-addon-domain.com
  MAIL_FROM_NAME="${APP_NAME}"
  

• 测试邮件发送：添加一个临时路由或Artisan命令验证，同时查看Laravel日志排查隐藏错误：

  Route::get('/test-external-email', function () {
      try {
          Mail::raw('External email test content', function ($message) {
              $message->to('your-test-gmail@gmail.com')->subject('Laravel External Email Test');
          });
          return 'Test email sent, check inbox/spam folder';
      } catch (\Exception $e) {
          return 'Error: ' . $e->getMessage();
      }
  });
  

  执行后检查Gmail的收件箱和垃圾邮件文件夹，同时查看storage/logs/laravel.log是否有未抛出的异常。

二、检查附加域名的DNS记录 #

• SPF记录：确保附加域名的TXT记录包含Bluehost的SPF规则。如果已有SPF记录，不要重复创建，仅合并include:bluehost.com到现有规则中：
  正确格式示例：

  v=spf1 a mx include:bluehost.com ~all
  

  说明：~all表示非授权来源的邮件会被标记为可疑，比-all更温和，避免误拦截现有业务邮件。
• DKIM记录：登录Bluehost控制面板，找到附加域名的邮件管理模块，生成DKIM密钥，然后添加对应的TXT记录到DNS解析中。Bluehost主域名通常自动配置DKIM，但附加域名需要手动操作。
• 反向解析（PTR记录）：联系Bluehost客服，要求为附加域名绑定的服务器IP设置反向解析，指向你的附加域名。这是Gmail等外部邮箱反垃圾邮件的核心校验项，Bluehost默认不为附加域名开启此配置。

三、Bluehost附加域名的特殊限制处理 #

• 邮件发送配额：在Bluehost控制面板的邮件管理中查看附加域名的邮件发送配额，若超出配额会被静默拦截，无报错提示。如果配额不足，可申请提升或调整发送频率。
• SMTP认证强制：附加域名必须使用自身邮箱账号完成SMTP认证，不能共享主域名的SMTP信息，否则会触发外部邮箱的反垃圾规则。

四、避免影响现有业务的操作建议 #

• 修改DNS前备份当前所有解析记录（截图或导出），一旦出现异常可快速恢复。
• 分步骤验证：先切换Laravel的SMTP配置，确认内部邮件仍能正常发送后，再修改DNS记录。
• SPF记录修改采取增量方式：仅添加include:bluehost.com到现有SPF规则中，不要替换整个记录，避免影响其他业务的邮件投递。

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