Laravel定时任务开启runInBackground后无法写入Redis缓存问题求解

问题根因 #

Laravel的runInBackground()实现逻辑是fork独立子进程执行命令，不会继承调度主进程的上下文配置，出现写入缓存失败基本都是以下几个原因：

• 后台子进程默认加载默认.env配置，没有指定对应环境参数，导致Redis连接信息（地址、库号、前缀、密码）和你读取数据时用的配置不一致，数据写到了其他Redis库/带了其他前缀，读取时自然返回null
• 你同时用了onOneServer()特性，该特性默认用文件缓存实现锁逻辑，后台子进程运行用户和调度进程用户权限不一致，锁文件无法正常读取，导致任务直接被拦截不执行
• runInBackground()默认会把所有输出重定向到/dev/null，任务执行过程中的报错（比如Redis连接失败、类不存在）你看不到，误以为是写入逻辑异常

解决方案 #

按顺序排查即可解决：

第一步：添加日志输出确认任务执行状态 #

修改Kernel.php中的调度代码，把任务输出重定向到日志文件，方便排查错误：

protected function schedule(Schedule $schedule)
{
   $schedule->command('data:cache')
        ->everyFiveMinutes()
        ->onOneServer()
        ->runInBackground()
        // 确保日志路径CLI运行用户有写入权限
        ->appendOutputTo(storage_path('logs/data_cache_schedule.log'));
}

任务执行后查看日志，就能看到具体报错信息。

第二步：显式指定运行环境，保证配置一致 #

如果日志显示任务正常执行没有报错，那就是环境配置加载错误，在命令中显式指定你实际使用的环境参数即可：

// 把production替换成你实际的环境名，比如local、staging
$schedule->command('data:cache --env=production')
    ->everyFiveMinutes()
    ->onOneServer()
    ->runInBackground()
    ->appendOutputTo(storage_path('logs/data_cache_schedule.log'));

同时可以在写入缓存的方法中增加临时日志，确认写入的Redis配置和读取时一致：

public function setCache()
{
    $data = ['one', 'two', 'three'];
    $redisStore = Cache::store('redis');
    // 打印当前用的Redis前缀、库号，确认和你读取时的配置一致
    \Log::debug('Redis写入配置', [
        'prefix' => $redisStore->getPrefix(),
        'db' => config('database.redis.cache.database')
    ]);
    $res = $redisStore->put('data', $data, now()->addMinutes(10));
    \Log::debug('Redis写入结果', ['status' => $res]);
}

第三步：修复onOneServer()锁异常 #

如果日志显示任务根本没执行，就是调度锁的问题，新建/修改config/schedule.php，指定调度锁用Redis驱动，避免文件锁权限问题：

return [
    'cache' => 'redis',
];

以上操作做完后就能正常后台并行执行任务，同时写入Redis缓存正常。

内容的提问来源于stack exchange，提问作者mr.incredible