PHPMailer 6.9通过CronJob无法发邮件，浏览器运行正常

以下是浏览器运行正常但CronJob执行失败的常见原因及对应解决方案：

1. PHP执行路径不匹配 #

• 问题：Cron默认使用系统CLI版本的PHP，可能和Web服务器（如Apache/Nginx）使用的PHP版本或配置不同，导致PHPMailer依赖的扩展（如openssl）未启用，或脚本存在语法兼容问题。
• 解决：
  • 查看Web服务器的PHP路径：在浏览器运行的脚本中添加echo phpinfo();，找到"Loaded Configuration File"对应的路径。
  • 查看系统CLI的PHP路径：执行which php，若两者版本不同，在Cron命令中指定Web服务器对应的PHP路径，例如：

    * * * * * /usr/bin/php8.1 /var/www/html/script.php
    

2. 脚本文件路径错误 #

• 问题：浏览器运行时当前工作目录是网站根目录，相对路径（如require 'Email.php'）能正常加载文件；但Cron执行时当前目录是用户主目录，导致依赖文件找不到。
• 解决：将所有文件引用改为绝对路径，利用PHP内置的__DIR__常量拼接路径，例如：

  // 替换相对路径引用
  require_once __DIR__ . '/init.php';
  require_once __DIR__ . '/Email.php';
  // 若用Composer加载PHPMailer
  require_once __DIR__ . '/vendor/autoload.php';
  

3. 环境变量缺失 #

• 问题：Web环境下PHP会自动设置$_SERVER系列变量（如DOCUMENT_ROOT），但CLI模式下这些变量不存在，若脚本依赖它们会初始化失败。
• 解决：
  • 替换$_SERVER['DOCUMENT_ROOT']为__DIR__或手动定义根目录：

    define('ROOT_DIR', __DIR__ . '/../');
    

  • 若需要特定环境变量，可在Cron命令中手动设置：

    * * * * * DOCUMENT_ROOT=/var/www/html /usr/bin/php /var/www/html/script.php
    

4. 权限不足 #

• 问题：Cron执行脚本的用户（默认是创建Cron的用户）可能和Web服务器运行用户（如www-data）不同，导致无法读取依赖文件、写入日志，或连接SMTP服务器时权限受限。
• 解决：
  • 查看Web服务器用户：执行ps aux | grep apache或ps aux | grep nginx获取用户（如www-data）。
  • 在Cron中指定该用户执行脚本：

    * * * * * www-data /usr/bin/php /var/www/html/script.php
    

  • 确保脚本及依赖文件的权限允许该用户访问：

    chown -R www-data:www-data /var/www/html/
    chmod -R 755 /var/www/html/
    

5. 错误日志未开启，无法定位问题 #

• 问题：Cron执行出错时默认不输出错误信息，导致无法明确故障点。
• 解决：在script.php开头添加错误日志配置，主动捕获错误：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  ini_set('error_log', '/var/www/html/cron_mail_error.log');
  

  执行Cron后查看日志文件，根据错误信息（如"找不到Email.php"、"openssl扩展未启用"）针对性修复。

6. SMTP连接限制 #

• 问题：部分SMTP服务商会对非Web环境的连接进行限制，或CLI模式下PHP的openssl扩展未启用，导致无法建立SMTP连接。
• 解决：
  • 检查CLI版本PHP的扩展状态：执行php -m，确认openssl在列表中；若没有，修改对应PHP的php.ini文件，启用extension=openssl。
  • 开启PHPMailer调试模式排查连接问题：

    $mail->SMTPDebug = SMTP::DEBUG_SERVER; // 调试日志会输出到error_log中
    

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