ThinkPHP 8 定时任务需逐层验证：命令类是否被识别、能否独立执行、调度器是否启用、Linux crontab 是否正确配置绝对路径与工作目录，并重定向日志。
ThinkPHP 8 的定时任务不是“配完就能跑”，必须逐层验证，漏掉任一环节都会导致线上静默失败。验证不是走流程，而是确认每一环是否真实就绪、可被调用、能执行。
命令类是否被框架识别
这是第一道关卡，不通过则后续全无意义。
- 在项目根目录执行 php think list，检查输出中是否明确出现你定义的命令名（如
cron:clean-cache） - 若未列出，立即检查三项：文件路径是否为
app/command/CleanCache.php；命名空间是否严格为app\command；configure()方法内是否调用了$this->setName('xxx') - 注意大小写和空格：类名
CleanCache对应文件名CleanCache.php，命令名cron:clean-cache中不能含中文、空格或特殊符号
命令能否独立执行成功
能列出来 ≠ 能跑通。这步验证逻辑与环境是否真实可用。
- 直接运行 php think cron:clean-cache（替换成你的命令名）
- 观察终端是否输出
缓存已清空类提示，并同步检查runtime/cache/目录是否实际清空 - 若报错
Class not found或Command not defined，优先排查app/command.php是否存在、是否返回数组、数组中是否完整写入了带命名空间的类路径（如'app\command\CleanCache'）
调度器配置是否启用且匹配环境
如果你用的是 think schedule:run 方式（非直接调用自定义命令），此步决定任务是否进入调度队列。
立即学习“PHP免费学习笔记（深入）”；
- 打开
config/console.php，确认'scheduling' => true已显式开启 - 默认仅在
APP_ENV=production下执行调度逻辑，开发测试时需临时加环境变量：APP_ENV=production php think schedule:run -v - 手动运行后若仍显示
No scheduled commands are ready to run，说明要么时间未到（比如写了->everyMinute()但当前秒数未触发），要么该命令未在app/command/下、未正确setName、或execute()中有未捕获异常中断流程
Linux crontab 调用是否真正生效
这是最后一环，也是线上失败率最高的环节——cron 环境与你的 shell 完全隔离。
- crontab 条目必须用绝对路径：
/usr/bin/php（用which php确认）、/var/www/myapp/think（项目绝对路径） - 必须显式切换工作目录：
cd /var/www/myapp && /usr/bin/php think cron:clean-cache - 务必重定向日志：
>> /var/log/cron-clean.log 2>&1，否则失败无声无息 - 首次调试建议用高频表达式（如
* * * * *）配合简单命令（如echo $(date) >> /tmp/test-cron.log）先验证 cron 自身是否工作
