如何在AWS实例上配置Laravel Scheduler定时任务

整个配置流程分为Laravel侧任务定义、服务器cron规则配置两步，不需要额外复杂依赖。

1. Laravel侧编写定时任务逻辑 #

首先在项目里定义你要跑的业务逻辑：

• 打开项目下的app/Console/Kernel.php文件，找到schedule方法，添加对应调度规则：

<?php

namespace App\Console;

use Illuminate\Console\Scheduling\Schedule;
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;
use Illuminate\Support\Facades\DB; // 记得引入DB门面

class Kernel extends ConsoleKernel
{
    protected function schedule(Schedule $schedule)
    {
        // 定义每分钟执行的任务：指定表的指定列数值自增1
        $schedule->call(function () {
            // 将下面的表名、列名替换成你实际业务的字段
            DB::table('your_table_name')->increment('your_target_numeric_column');
        })->everyMinute(); // 调度频率设置为每分钟执行
    }
}

如果你的业务逻辑比较复杂，可以通过php artisan make:command YourTaskCommand生成独立的Artisan命令，把自增逻辑写到命令的handle方法里，再在schedule里用$schedule->command('your:command-name')->everyMinute()调用即可。

2. AWS实例侧配置Cron触发规则 #

不管你用的是AWS EC2、LightSail等基于Linux的计算实例，cron配置逻辑完全一致：

• 首先通过SSH登录到你的AWS实例，切换到Laravel项目对应的运行用户（常见为www-data、nginx、ec2-user，不要用root用户跑定时任务，避免后续文件权限错乱）
• 执行crontab -e编辑当前用户的定时任务列表，第一次打开如果提示选择编辑器，选你熟悉的nano或vim即可
• 在打开的配置文件最末尾，添加如下cron规则：

* * * * * cd /your/laravel/project/absolute/path && php artisan schedule:run >> /dev/null 2>&1

• 开头* * * * *是cron原生时间规则，代表每分钟执行一次后续命令
• /your/laravel/project/absolute/path替换成你实例上Laravel项目的实际根目录，比如常见路径为/var/www/html/laravel-demo
• 如果你的php命令没有配置全局环境变量，要写php的完整绝对路径，可以在实例上执行which php查到实际路径，比如替换为/usr/bin/php
• 末尾>> /dev/null 2>&1是默认丢弃命令输出，如果需要排查问题，可以临时把输出重定向到日志文件，比如改为>> /var/www/html/laravel-demo/storage/logs/schedule.log 2>&1，方便查看报错
• 保存退出编辑器后，执行crontab -l确认刚才添加的规则已经在列表中，cron服务会自动加载新规则，无需手动重启。

3. 效果验证 #

配置完成后等待1-2分钟，直接查询MySQL对应表的目标列数值，确认数值是否每分钟自动+1即可。如果未生效优先排查三个常见问题：

• Laravel项目的storage、bootstrap/cache目录是否给定时任务运行用户开放了读写权限
• 项目路径、php路径是否写的是绝对路径，没有拼写错误
• 项目.env文件中的数据库连接配置是否正确，能否正常连通MySQL

内容的提问来源于stack exchange，提问作者zubair syslab