cPanel定时Cron任务未按计划执行PHP脚本问题排查

1. 确认时区配置 #

Cron默认使用系统时区，而非cPanel面板设置的时区。德国时区为Europe/Berlin，需强制指定时区：

• 在Cron任务开头添加时区声明：

  TZ='Europe/Berlin' 0 0 * * * 你的执行命令
  

• 或在PHP脚本开头硬编码时区：

  date_default_timezone_set('Europe/Berlin');
  

2. 修复环境变量与路径差异 #

手动执行与Cron的运行环境完全不同，核心差异在于PATH和工作目录：

• 指定完整路径：
  • PHP脚本执行需用绝对路径：

    /usr/local/bin/php /home/你的用户名/public_html/你的脚本.php
    

    可通过which php命令在SSH中获取PHP的完整路径
  • curl命令同样需指定绝对路径：

    /usr/bin/curl https://你的域名/api/检查接口
    

    可通过which curl获取curl路径
• 修正脚本相对路径：
  如果PHP脚本中使用了相对路径（如include './config.php'），Cron的工作目录是用户根目录（/home/你的用户名/），而非脚本所在目录。需在脚本开头切换目录：

  chdir(dirname(__FILE__)); // 切换到脚本所在目录
  

3. 捕获执行错误日志 #

Cron默认不会输出错误信息，需将执行日志重定向到文件，以便排查：

• 在Cron命令末尾添加日志输出：

  0 0 * * * /usr/local/bin/php /home/你的用户名/public_html/脚本.php >> /home/你的用户名/cron_error.log 2>&1
  

  查看日志文件cron_error.log，可直接定位PHP报错、curl请求失败等问题。

4. 检查权限与依赖 #

• 脚本权限：确保PHP脚本权限为755（所有者可执行，其他用户可读），避免Cron无权限执行。
• 文件写入权限：如果脚本需要生成文件/写入数据库，需确保目标目录/数据库有当前Cron用户的读写权限。
• API认证问题：如果你的API需要身份验证（如会话、Token），手动调用时浏览器会携带会话，但Cron的curl请求是无状态的，需在curl中添加认证参数：

  /usr/bin/curl -H "Authorization: Bearer 你的Token" https://你的域名/api/检查接口
  

5. 验证Cron命令正确性 #

将Cron命令复制到SSH中直接执行，模拟Cron的运行环境，看是否能正常生成任务：

• 先切换到Cron的工作目录：cd /home/你的用户名/
• 执行完整的Cron命令，比如：/usr/local/bin/php /home/你的用户名/public_html/脚本.php
  如果执行失败，会直接输出错误信息，快速定位问题。

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