laravel 12任务调度需三层时区对齐:应用配置(config/app.php设为'asia/shanghai')、服务器系统(timedatectl set-timezone asia/shanghai)、调度定义(用timezone('asia/shanghai')显式指定),三者不一致会导致执行时间偏差。

Laravel 12 任务调度的时区设置,关键在于三层对齐:应用配置、服务器系统、调度定义本身。只要其中一层不一致,就可能出现“明明设了每天9点执行,结果在北京时间17点才跑”的问题。
确认并统一 Laravel 应用时区
打开 config/app.php,检查 'timezone' 配置项:
'timezone' => 'Asia/Shanghai',
这个值必须是你业务实际所在的时区(例如中国用 Asia/Shanghai,美国东部用 America/New_York)。Laravel 默认是 UTC,如果没改过,它就会按世界标准时间解析所有 dailyAt('09:00') 这类写法——相当于北京时间17:00。
验证并同步服务器系统时区
Laravel 调度器底层依赖服务器的 Cron 守护进程,而 Cron 是按系统本地时间判断是否触发的。运行以下命令查看当前系统时区:
timedatectl status | grep "Time zone"
如果显示 Time zone: UTC,但你的业务在东八区,就需要同步:
sudo timedatectl set-timezone Asia/Shanghai- 修改后无需重启 PHP 或 Web 服务,但建议重载 Cron:
sudo systemctl reload cron(或crond,依系统而定)
在调度定义中显式指定时区(推荐)
即使前两层已对齐,跨环境部署(如开发用本地时区、生产用服务器时区)仍可能出错。最稳妥的方式是在每个任务中用 timezone() 方法锁定:
$schedule->command('reports:generate')<br> ->dailyAt('08:30')<br> ->timezone('Asia/Shanghai');
这样无论服务器或应用配置如何变化,该任务都严格按东八区时间执行。对多时区 SaaS 类应用,还可动态传入用户所在时区字符串。
额外提醒:避免 php.ini 与应用配置冲突
PHP 自身也有 date.timezone 设置(在 php.ini 中)。如果这里设为 UTC,而 Laravel 的 config/app.php 设为 Asia/Shanghai,DateTime 类等底层行为可能受干扰。建议保持三者一致:系统时区、php.ini、Laravel config。











