Eloquent模型不支持DelayQueue属性，它只是项目自定义字段或误解；延迟执行应通过Artisan Command+Schedule实现定时任务，或用Job->delay()实现异步延迟作业。
PHP中Eloquent模型不能直接支持DelayQueue属性
Eloquent本身没有DelayQueue这个属性或机制，它也不是Laravel内置的调度概念。你看到的DelayQueue大概率是项目自定义的字段名、注释标记，或是误把消息队列（如Redis Delayed Job）或定时任务逻辑套在Eloquent模型上理解了。
常见错误现象：Undefined property: App\Models\Order::$delayQueue 或模型保存后延迟逻辑没触发。
- 数据库表里加了个
delay_queue字段，但没配casts或getDelayQueueAttribute访问器，读出来就是null - 想用
->delay(60)像dispatch()那样调用，结果报Call to undefined method - 把
Schedule里的$schedule->job(...)->daily()和模型字段混为一谈，以为设个字段就能自动进队列
Laravel定时任务调度不依赖Eloquent属性，靠Command+Schedule
真正实现“延迟执行”的核心路径是：写一个Artisan Command → 在App\Console\Kernel::schedule()里注册 → 由系统crontab触发。Eloquent模型只负责数据承载，不参与调度编排。
使用场景：比如订单超时未支付自动取消，不是靠模型有个delay_queue字段就自动生效，而是靠定时命令每分钟查一次created_at 。
立即学习“PHP免费学习笔记（深入）”；
- 命令类必须继承
Illuminate\Console\Command，且实现handle() -
schedule()方法里不能写业务逻辑，只做调度声明，例如：$schedule->command('order:expire')->everyMinute(); - 确保服务器crontab已配置
* * * * * cd /var/www/app && php artisan schedule:run >> /dev/null 2>&1
需要真延迟队列？用Job+delay()，别绑在Eloquent属性上
如果要的是“创建订单5分钟后发通知”，这不是定时任务，而是异步延迟作业，应走dispatch()->delay()，和Eloquent模型解耦。模型可以提供toMail()或toArray()供Job消费，但不该自己带“延迟”行为。
性能影响：在模型saved事件里直接dispatch((new SendOrderNotice($this))->delay(now()->addMinutes(5)))是可行的，但要注意：
- 数据库事务未提交时调用
delay()，可能因事务回滚导致Job仍被投递（Laravel 9+默认启用after_commit可缓解） - 不要在
getDelayQueueAttribute()里返回Carbon对象期望框架自动delay——没这机制 - Redis作为队列驱动时，需确认
queue:work进程正在运行，否则delayed job永远不执行
示例正确写法：
OrderCreated::dispatch($order)->delay(now()->addSeconds(300));
自定义字段如delay_queue只能作状态标记，不能替代调度逻辑
如果你坚持在模型加delay_queue字段（比如存JSON记录延迟类型、时间、重试次数），它只是个普通字段，作用仅限于：人工排查、条件查询、或作为Job入参的一部分。
容易踩的坑：
- 用
$model->delay_queue = 'notify'; $model->save();之后，不额外触发dispatch或schedule，什么都不会发生 - 在
booted()里监听updated事件，发现delay_queue变了就dispatch——这逻辑易重复触发，且无法控制延迟时间 - 字段命名含
queue却没配casts，存数组时变成Array to string conversion错误
真要关联延迟动作，建议用观察者模式显式触发：
static::updated(function ($model) { if ($model->isDirty('delay_queue') && $model->delay_queue === 'send_sms') { SendSmsJob::dispatch($model)->delay(now()->addMinutes(1)); } });
复杂点在于延迟策略会分散在模型、Job、Command、Schedule多个地方，得靠清晰的命名和文档对齐意图，而不是指望一个字段自动完成所有事。
