Laravel定时任务问题：仅当无匹配进程时执行进程（Linux/PHP）

这个问题我之前也碰到过，调度器重复创建进程大概率是你的进程检测逻辑在CLI环境下没工作到位，或者没考虑到调度器本身的进程干扰。咱们一步步来解决：

核心问题分析 #

当你在Web端点执行时，进程检测逻辑能正确识别目标进程；但调度器是通过php artisan schedule:run每分钟执行一次，可能出现两种情况：

• 检测逻辑误判，没识别到已经运行的目标进程
• 检测时把调度器自身的进程也算成了目标进程，或者匹配规则太宽松

方案一：精确的进程检测（基于命令匹配） #

如果想用进程名称检测，一定要过滤掉当前执行检测的进程（也就是调度器触发的这个检查脚本），避免误判。代码示例：

use Illuminate\Support\Facades\Process;

// 替换成你的目标进程完整命令，比如 'php artisan my:long-task'
$targetCommand = 'php artisan my:long-task';

// 执行检测命令：匹配目标进程，同时排除当前脚本的PID（$$是当前进程ID）
$checkCommand = "pgrep -f '$targetCommand' | grep -v $$";
$result = Process::run($checkCommand);

// 判断是否有正在运行的目标进程
$isRunning = !empty(trim($result->output()));

if (!$isRunning) {
    // 启动目标进程（异步后台运行）
    Process::start($targetCommand);
}

方案二：PID文件锁（更可靠的方式） #

进程名称匹配容易受命令路径、参数变化影响，用PID文件跟踪运行中的进程ID是更稳妥的方案：

步骤1：编写检测与启动逻辑 #

use Illuminate\Support\Facades\Process;

$pidFile = storage_path('app/long-task.pid');

// 检查PID文件是否存在
if (file_exists($pidFile)) {
    $existingPid = trim(file_get_contents($pidFile));
    
    // 验证PID对应的进程是否还存活（Linux下用kill -0，Windows需替换为tasklist命令）
    $isAlive = Process::run("kill -0 $existingPid 2>/dev/null")->successful();
    
    if ($isAlive) {
        // 进程还在运行，直接退出
        return 0;
    }
    
    // 如果PID文件存在但进程已死，清理无效文件
    unlink($pidFile);
}

// 启动目标进程并记录PID
$process = Process::start('php artisan my:long-task');
file_put_contents($pidFile, $process->id());

// 可选：在目标任务的代码末尾添加清理PID文件的逻辑，避免进程异常退出后残留文件
// 比如在my:long-task命令的handle方法最后加上：
// unlink(storage_path('app/long-task.pid'));

步骤2：配置调度器 #

把上面的逻辑封装成一个Laravel命令（比如my:check-and-start），然后在调度器里只触发这个检查命令：

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    // 每分钟检查一次，只有当目标进程未运行时才启动
    $schedule->command('my:check-and-start')->everyMinute();
}

注意事项 #

• 权限问题：确保storage目录对调度器运行的用户（比如www-data或者你的系统用户）有读写权限，否则PID文件无法创建或删除
• Windows适配：如果是Windows服务器，进程检测命令要替换成tasklist /FI "PID eq $existingPid"，不能用kill -0
• 避免直接调度长期任务：不要直接把长期运行的任务放到调度器里每分钟执行，一定要通过检查逻辑来控制启动

内容的提问来源于stack exchange，提问作者Diego Ponciano