Laravel 模型观察者中使用 Bus::chain 触发任务链时，若链中某个任务修改了同一模型（如更新 last_sync 字段），会再次触发 updated 事件，导致无限递归调度——本文详解定位过程与安全规避方案。
laravel 模型观察者中使用 bus::chain 触发任务链时，若链中某个任务修改了同一模型（如更新 `last_sync` 字段），会再次触发 `updated` 事件，导致无限递归调度——本文详解定位过程与安全规避方案。
在 Laravel 自定义包开发中，通过模型观察者（Observer）监听 DedicatedServer 的 created 和 updated 事件，并在其中调度一个包含多个同步任务的 Bus 链，是一种常见且合理的解耦设计。然而，当链中最后一个任务 SetLastSync 执行 $dedicatedServer->update(['last_sync' => now()]) 时，它会主动触发同一模型的 updated 事件——而该事件又会重新执行整个 Bus 链，形成「调度 → 更新 → 再调度 → 再更新…」的死循环。
根本原因在于：Laravel 的 updated 事件不区分字段变更来源，只要模型调用了 save()、update() 或批量更新方法，且数据库实际发生了变更（哪怕仅 updated_at 或 last_sync 字段），就会触发观察者。而 SetLastSync 任务正是这个循环的“闭合点”。
✅ 正确做法是：在 updated 方法中增加变更字段白名单校验，仅当业务关键字段（如 ip、port、api_key 等）被修改时才执行同步链，排除纯状态/时间戳字段的干扰：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
public function updated(DedicatedServer $dedicatedServer)
{
// 仅当非元数据字段发生变更时才触发同步链
$changedFields = array_diff(
array_keys($dedicatedServer->getChanges()),
['updated_at', 'last_sync'] // 忽略这些字段的变更
);
if (empty($changedFields)) {
return; // 无业务相关变更，跳过调度
}
$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();
}
⚠️ 注意事项：
-
避免在链中修改触发源模型：如必须更新时间戳，建议使用
touch()或直接操作数据库（如DB::table()->where()->update()），绕过 Eloquent 事件系统； -
created无需此检查：因新建记录无历史变更，天然不会引发循环； -
测试验证：可通过
php artisan tinker模拟仅更新last_sync字段，确认updated方法是否静默退出； -
扩展性考虑：可将白名单逻辑封装为模型方法（如
hasBusinessChanges()），提升可维护性。
通过精准识别变更源头并实施字段级条件控制，即可彻底阻断 Bus 链的意外递归，确保同步任务稳定、可控、按需执行。
