
Laravel 的任务调度器需借助系统级 Cron 守护进程每分钟触发一次 schedule:run 命令,才能自动执行如 OTP 过期清理等定时任务;仅靠 php artisan serve 无法启用调度,必须配置服务器 Cron。
laravel 的任务调度器需借助系统级 cron 守护进程每分钟触发一次 `schedule:run` 命令,才能自动执行如 otp 过期清理等定时任务;仅靠 `php artisan serve` 无法启用调度,必须配置服务器 cron。
Laravel 的任务调度(Task Scheduling)并非内建常驻进程,而是一个“被动触发”机制:它本身不运行后台服务,而是依赖外部定时器(如 Linux 的 Cron)定期调用 php artisan schedule:run 命令,由该命令解析 app/Console/Kernel.php 中定义的 schedule() 方法,比对时间规则并执行匹配的任务。
例如,你已成功编写 Otp:expire 自定义命令,并在 Kernel.php 中注册了类似以下调度:
// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
$schedule->command('Otp:expire')->everyMinute();
// 或更合理的频率:->daily() / ->hourly() / ->cron('0 */2 * * *')(每两小时)
}✅ 当你手动运行 php artisan schedule:run 时,Laravel 会立即检查并执行符合条件的任务(如过期 OTP 清理),因此看到输出日志且数据被删除——这验证了命令逻辑和调度注册均正确。
❌ 但 php artisan serve 仅为开发用 HTTP 服务器,不具备定时能力,也不会监听或触发调度。它完全不参与 schedule:run 的执行流程。因此,即使 OTP 已超时,只要没有外部触发,任务就永远不会运行。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
? 正确解决方案:配置系统 Cron
在生产或测试服务器上(Linux/macOS),需将以下 cron 表达式添加至用户的 crontab:
# 编辑当前用户 crontab crontab -e
然后添加一行(请务必将 /path-to-your-project 替换为你的实际项目绝对路径,如 /var/www/my-laravel-app):
* * * * * cd /path-to-your-project && /usr/bin/php artisan schedule:run >> /dev/null 2>&1
? 注意事项:
- 使用绝对路径调用 PHP(如
/usr/bin/php或which php查得的真实路径),避免环境变量差异导致命令失败; - 确保 Web 服务器用户(如
www-data)或部署用户对项目目录有读写权限,尤其storage/logs/和storage/framework/schedule-*文件; - 开发阶段可临时使用
watch -n 60 'php artisan schedule:run'模拟(仅限本地调试,不可用于生产); - 部署到 Forge、Envoyer、Laravel Vapor 或 Docker 时,需按平台文档单独配置 Cron(例如 Docker 中需启用
crond服务并挂载 crontab)。
✅ 验证是否生效:
等待一分钟后,检查 storage/logs/laravel.log 是否出现 Running ['artisan' Otp:expire] 日志;同时查询数据库确认过期 OTP 是否被自动清理。
总结:Laravel 调度器是“指挥官”,Cron 才是“执行兵”。脱离 Cron,调度器永远静默。务必在服务器层完成这一关键配置,才能真正实现 OTP 过期自动清理等业务场景的无人值守运维。

















