Laravel 事件链中避免因模型更新触发无限递归任务的正确实践-php教程-PHP中文网

Laravel 事件链中避免因模型更新触发无限递归任务的正确实践

Laravel 模型观察器中，若链式任务末尾存在更新模型的操作（如修改 last_sync 字段），会再次触发 updated 事件，导致 Bus 链重复执行，形成无限循环。解决方案是过滤实际业务字段变更，忽略时间戳或同步标记类字段。

laravel 模型观察器中，若链式任务末尾存在更新模型的操作（如修改 `last_sync` 字段），会再次触发 `updated` 事件，导致 bus 郾链重复执行，形成无限循环。解决方案是过滤实际业务字段变更，忽略时间戳或同步标记类字段。

在 Laravel 应用中，使用 Bus::chain() 在模型事件（如 updated）中触发一系列异步任务是一种常见模式。但若链中最后一个任务（例如 SetLastSync）执行了 $model->update(['last_sync' => now()]) 或类似操作，它将再次触发 updated 事件——而该事件又会重新启动整条任务链，从而引发无限递归调度，造成队列积压、资源耗尽甚至服务异常。

根本原因在于：Laravel 的 updated 事件默认监听模型任意字段变更（包括 updated_at、last_sync 等非业务字段）。因此，必须显式区分「真实业务更新」与「内部状态更新」。

✅ 正确做法：在 updated 回调中校验是否为有意义的字段变更，仅在关键属性（如 ip、port、api_key 等）变化时触发链式任务：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

public function updated(DedicatedServer $dedicatedServer)
{
    // 仅当核心配置字段发生变更时才执行同步链
    $dirtyKeys = array_keys($dedicatedServer->getDirty());
    $relevantKeys = ['ip', 'port', 'api_key', 'api_sec', 'status'];

    if (array_intersect($dirtyKeys, $relevantKeys)) {
        $virtualizor = new Virtualizor(
            $dedicatedServer->ip,
            $dedicatedServer->port,
            $dedicatedServer->api_key,
            $dedicatedServer->api_sec
        );

        Bus::chain([
            new AllowServerTrafficOnCSF($dedicatedServer, $virtualizor),
            new SyncIPPools($dedicatedServer, $virtualizor),
            new SyncIPs($dedicatedServer, $virtualizor),
            new SyncOSTemplates($dedicatedServer, $virtualizor),
            new SyncStorages($dedicatedServer, $virtualizor),
            new SyncPlans($dedicatedServer, $virtualizor),
            new SyncVPSes($dedicatedServer, $virtualizor),
            new SetLastSync($dedicatedServer),
        ])->onConnection('database')
          ->onQueue('ip-service')
          ->dispatch();
    }
}

⚠️ 注意事项：

不要依赖 getChanges() 的空判断：updated_at 总是会被自动标记为 dirty，需主动过滤；

SetLastSync 任务内应使用 touch() 或 updateQuietly()（Laravel 9+），避免再次触发观察器：

// 推荐：静默更新，不触发事件
$dedicatedServer->updateQuietly(['last_sync' => now()]);
// 或者（Laravel timestamps = false;
$dedicatedServer->last_sync = now();
$dedicatedServer->save();
$dedicatedServer->timestamps = true;