ThinkPHP无原生定时任务HTTP接口，所谓“接口”实为Web路由+外部调度的伪定时方案，可靠性差；真正可靠的是CLI命令+系统crontab调度，并需注意环境隔离与错误捕获。
ThinkPHP 本身不提供“定时任务接口”这种原生 HTTP 接口，所谓“定时任务接口”，实际是开发者用 Web 路由暴露一个可被外部调用的 URL，再靠第三方调度器（如云函数、Crontab + curl、浏览器定时插件）来定期请求它。这种方式本质是伪定时，可靠性差，仅适合低频、非关键、无状态的轻量操作。
为什么不能直接用 HTTP 接口做定时任务
PHP 是无状态、请求即销毁的模型，一次 HTTP 请求结束后，所有内存、定时器、连接全部释放。即使你在控制器里写 sleep(60) 或用 pcntl_alarm，请求超时（Nginx 默认 60s、Apache 常为 300s）、网关中断、PHP-FPM worker 被回收，都会导致任务中途终止。
常见错误现象包括：
- 接口返回 504 Gateway Timeout，但后台逻辑只执行了一半
- 日志显示“开始执行”，却找不到“执行完成”记录
- 同一任务被并发触发多次（多个请求同时到达）
- 网站零访问时，任务完全不执行
如果真要用 HTTP 触发，必须加防护层
若受限于虚拟主机、无服务器权限，只能走 Web 方式，至少要加三道控制：
立即学习“PHP免费学习笔记（深入）”；
- 用
cache('cron_lock_mytask', true, 3600)设置带过期时间的锁，防止重复执行 - 在入口处校验来源 IP 或签名参数（如
token=hash_hmac('sha256', 'mytask'.TIME, $secret)），拒绝未授权调用 - 把核心逻辑封装进独立方法（如
app\common\service\CronService::clearExpiredCache()），不在控制器里写业务代码，便于后续迁移到 CLI
示例路由定义（route/app.php）：
Route::get('api/cron/clear_cache', 'api/Cron.clearCache')->middleware('throttle:1,3600');其中 throttle:1,3600 表示每小时最多触发 1 次，避免误刷或攻击。
真正可靠的“接口式”替代方案：CLI 命令 + 外部调度
ThinkPHP 的 think 命令才是设计用来承载定时逻辑的正路。所谓“接口”，应理解为对外暴露的 CLI 入口，而非 HTTP。
- 创建命令类：
app\command\ClearCache，继承think\console\Command - 在
configure()中设$this->setName('cron:clear-cache')，这就是你的“接口名” - 部署时用系统 crontab 调用：
0 2 * * * /usr/bin/php /path/to/think cron:clear-cache - 如需远程触发，可写个最小化 shell 脚本（
trigger_cron.sh），用 SSH 执行，比 HTTP 更可控
注意：crontab 中的 PHP 路径必须和 Web 环境一致（可用 which php 确认），否则可能因扩展缺失（如 pdo_mysql）报错。
最容易被忽略的点：环境隔离与错误捕获
Web 请求和 CLI 运行的 ThinkPHP 环境变量不同——APP_DEBUG 默认关闭、runtime 目录权限可能不对、数据库配置中 hostname 写了 127.0.0.1 却没开 MySQL 的本地 socket 支持。
务必在命令类的 execute() 开头加：
if (php_sapi_name() !== 'cli') {
exit('This command can only run in CLI mode.');
}并用 try...catch 包裹全部逻辑，将异常写入 log::write()，而不是依赖 echo 或 var_dump ——后者在守护进程或 crontab 中根本看不到输出。
