ThinkPHP定时任务在Linux部署_Crontab执行脚本配置指南

先说说最常见的问题：你明明在服务器上直接执行 php think schedule:run 一切正常，可一旦丢进 crontab 里，它就“装死”，什么也不干，连个报错都不给。这种情况，说白了，就两个原因最普遍：环境变量缺失，或者工作目录不对。

Linux 系统级的 crontab 在运行时，默认不加载用户自己的 shell 配置文件（比如 ~/.bashrc），这就导致它根本不知道 php 命令在哪，也找不到 Composer 的自动加载文件，甚至连项目配置里那些相对路径也跟着一起“迷路”。

要解决，其实很简单：

• 在 crontab 条目里，把路径写死：/usr/bin/php /var/www/your-app/think schedule:run。别指望它自己会找，直接告诉它。
• 用 cd 命令先切到项目根目录，再执行 PHP 命令，确保 think 能正确读取 config/ 和 runtime/ 目录：cd /var/www/your-app && /usr/bin/php think schedule:run。
• 最后，务必加上输出重定向 >> /tmp/schedule.log 2>&1，把标准输出和错误日志都抓出来。很多问题，看一眼日志就全明白了，最怕的就是静默失败。

为什么 schedule:run 必须配合 crontab 每分钟跑一次？

没错，ThinkPHP 自带的定时任务调度器，本质上是个“检查员”，它不负责自己计时。它只会在一分钟一次的轮询中，检查当前时间点有没有该执行的任务。所以，crontab 的最小调度粒度，就是它能达到的最高精度。

这里有几个实操上的关键点：

• 别想着写成每 5 秒跑一次。首先，crontab 本身就不支持秒级调度。其次，高频调用会导致大量的 PHP 进程堆积，还没来得及处理完上一个，下一个又来了，最终把服务器资源吃光。
• 标准的写法就是 * * * * *（每分钟执行一次），然后依赖 think schedule:run 内部的锁机制来防止任务重复执行。这个锁能保证在同一时刻，同一个任务只会运行一个实例。
• 如果你的任务有非常严格的时间要求，比如必须准点整点推送，那千万不能完全依赖 cron 的触发时刻。你得在任务逻辑内部加上时间判断条件，确保它只在精确的时间点执行。

线上执行 think 命令报 Class not found 或 Undefined index: HTTP_HOST

这两个错误很有代表性。前者多半是 Composer 的 autoloader 没加载成功，后者则是因为框架在命令行模式下一不小心跑到了 Web 环境下。

排查和解决建议：

• 首先确认 think 文件头部是否包含了 require __DIR__.'/vendor/autoload.php';。这是 autoloader 的入口，如果它没生效，那所有第三方库都找不到。
• 其次，在命令行启动时，可以强制指定应用模式：/usr/bin/php -d "app_mode=console" think schedule:run。这能防止框架在找不到明确指令时，自动回退到 http 模式，从而避免读取 Web 专属配置。
• 最后，仔细检查你自己写的自定义命令。看看里面是不是直接用了 request()->host() 这类依赖 HTTP_HOST 的方法。在命令行下，Request 对象根本不会设置这个参数，一用就报错。

如何让多个 ThinkPHP 应用共享一台服务器的 crontab？

关键就两点：隔离和明确。如果不做隔离，多个应用的任务日志、运行状态会互相干扰，甚至在权限上出问题。因为 Linux 的系统级 crontab 所有条目共享一个执行上下文，不能靠切换用户来隔离。

具体的操作方式：

• 每个应用都单独用 crontab -e 来配置任务，并且最好切换到对应的部署用户下。比如 Web 服务是 www-data 用户在跑，那它的所有任务就在 www-data 的用户 crontab 里配置。
• 路径全部用绝对路径：PHP 的安装路径、项目的根目录、日志文件的存放位置，一个都不能含糊。不同用户的 HOME 环境变量不同，用相对路径很容易出问题。
• 给每个任务加上唯一标识的日志前缀。比如在命令前加上 echo "[appA] $(date)" >> /var/log/appa-schedule.log &&，这样排查问题时，一眼就能知道日志来自哪个应用的哪个任务。

有一个点特别容易被忽略：runtime 目录的权限。crontab 是以非登录的、指定用户的身份运行的，它很可能没有权限往 runtime/log/ 里写文件。结果就是，任务看起来执行成功了，但日志根本记不下来，缓存也写不进去。排错的时候，这往往会把你带进一个死胡同。