定时任务未执行的首要原因是系统cron未正确调用php artisan schedule:run；需验证cron配置、路径权限、锁机制及onOneServer()依赖的缓存驱动是否匹配。
定时任务没跑起来？先确认 schedule:run 是否被正确调用
Laravel 的调度器本身不运行任务，它只是个“计划表生成器”——真正触发执行的是系统级的 cron，而 cron 只负责每分钟调一次 php artisan schedule:run。如果任务没执行，90% 是这一步断了。
实操建议：
- 手动执行
php artisan schedule:run，看输出是否列出待执行的任务（比如Running scheduled command: App\Console\Commands\SendDailyReport），这是最直接的验证方式 - 检查服务器 cron 是否配置：运行
crontab -l，确认存在类似* * * * * cd /var/www/myapp && php artisan schedule:run >> /dev/null 2>&1的条目 - 路径必须写绝对路径，
cd到项目根目录再执行，否则artisan可能找不到配置或加载不到命令 - 注意用户权限：cron 默认以当前用户运行，但部署时常用
www-data或nginx用户，而该用户可能无权读取 .env 或写入 storage/logs/
$schedule->command() 和 $schedule->call() 怎么选
前者走完整的 Artisan 命令生命周期（支持参数、选项、输入模拟、事件触发），后者直接调函数，轻量但绕过中间件和异常处理机制。
常见错误现象：用 call() 调用一个需要数据库连接的闭包，却在 AppServiceProvider 中没做延迟绑定，导致容器未就绪时报 Target class [db] does not exist。
使用场景建议：
- 需要传参、记录日志、依赖命令行选项（如
--force）→ 用command('backup:database --gzip') - 纯计算型小任务（比如更新缓存计数器）且确定不依赖任何服务启动顺序 → 可用
call(function () { cache()->increment('hits'); }) - 涉及队列、邮件、数据库操作 → 强烈推荐封装为独立 Command 类并用
command()，避免闭包序列化失败或上下文丢失
本地开发时任务总被跳过？检查 withoutOverlapping() 和锁文件位置
Laravel 默认用文件锁防重复执行，锁文件存在 storage/framework/cache/data/ 下，名字形如 schedule-xxx.lock。开发时若用 Homestead/Valet/Docker，常因挂载权限、NFS 缓存或 SELinux 导致锁文件创建失败或读取失效，结果就是任务被判定“已在运行”，直接跳过。
实操建议：
- 临时加
->withoutOverlapping(0)测试是否锁机制干扰（0 表示不等待，直接跳过） - 改用数据库锁：在
config/app.php中设置'schedule_cache' => 'database'，并确保cache配置指向数据库驱动（如redis或database） - 不要在
withoutOverlapping()后接->runInBackground()—— 这俩组合会导致子进程无法释放锁，后续任务永远被阻塞 - 锁超时时间默认 1440 分钟（24 小时），线上长任务务必显式设更短值，比如
->withoutOverlapping(30)
任务里发邮件/调 API 失败？别忽略 onOneServer() 和环境隔离
多台服务器部署时，schedule:run 在每台机器上都会执行，除非显式加 onOneServer()。但这个方法依赖缓存驱动的原子操作，如果用的是 file 缓存，它根本不起作用——因为各服务器读写的是本地文件，互不可见。
性能与兼容性影响：
- Redis 缓存是
onOneServer()的实际生效前提；用 database 驱动也行，但会多一次 DB 查询 - 本地开发用
array或file缓存时，onOneServer()等于没写，任务会在每个 CLI 实例中重复跑 - 任务内调外部 API 时，别假设环境变量（如
MAIL_MAILER）和线上一致；建议在命令类的handle()开头加if (app()->environment('local')) return;快速屏蔽
复杂点在于：锁机制、缓存驱动、部署拓扑三者必须对齐，漏掉任一环，定时任务就从“自动执行”退化成“随机执行”。很多人卡在“为什么测试机 OK，上生产就双倍发送”，答案往往藏在缓存配置和服务器数量之间。
