dispatch()能否异步取决于队列驱动配置,需确认QUEUE_CONNECTION非sync、队列表已建、Redis连通;高频任务须设延迟与重试;任务类只传基础类型或Eloquent模型ID;queue:work须用Supervisor守护并配置autorestart。

用 dispatch() 发任务,但得先确认驱动是否就绪
PHP框架(如 Laravel)里发队列任务不是调个函数就完事,dispatch() 能否真正异步,取决于底层队列驱动配置。常见错误是本地开发时用了 sync 驱动——看着任务“执行了”,其实是在当前请求里同步跑的,根本没进队列。
- 检查
.env中QUEUE_CONNECTION是否设为redis、database或beanstalkd,而非sync - 运行
php artisan queue:work前,先用php artisan queue:failed-table和php artisan migrate确保数据库队列表已建好(若用database驱动) - Redis 驱动需确保
redis扩展已启用,且REDIS_HOST、REDIS_PORT可连通,否则任务会静默失败
高频操作要加延迟和重试,别直接 dispatchNow()
用户注册发邮件、支付成功写日志这类高频动作,如果无脑用 dispatchNow() 或没设重试,容易压垮下游服务或丢任务。Laravel 默认重试次数是 1 次,对网络抖动或临时超时远远不够。
- 用
->delay(now()->addSeconds(5))错开瞬时峰值,尤其在批量导入、活动秒杀等场景 - 在任务类里定义
public $tries = 3;,并配合public $backoff = 3;实现指数退避 - 避免在控制器里直接
dispatchNow(),它绕过队列系统,失去异步和失败重试能力
任务类里别传闭包、资源句柄或未序列化对象
队列任务本质是序列化后存入存储(Redis/DB),再由 worker 反序列化执行。传了闭包、mysqli 连接、fopen() 返回的 resource,反序列化时直接报 Serialization of 'Closure' is not allowed 或更隐蔽的空指针。
- 只传基础类型(
int、string、array)或 Eloquent 模型(Laravel 自动处理模型序列化) - 需要复杂逻辑?把参数拆成 ID,任务内用
User::find($id)重新查,而不是传整个$user对象实例 - 上传文件路径可传,但别传
$_FILES数组——它含 resource,必须先move_uploaded_file()存到磁盘再传路径
queue:work 进程要守护,不能靠手动敲命令
开发时敲一次 php artisan queue:work 看着能跑,但生产环境必须用进程管理器拉住,否则崩溃或部署后就断了。常见误区是以为 supervisor 配好就一劳永逸,结果发现日志里一堆 Connection refused 却没报警。
立即学习“PHP免费学习笔记(深入)”;
- Supervisor 的
autostart=true和autorestart=true必须开启,且startsecs设为 2+,避免启动太快被误判失败 - 加
--max-jobs=1000参数防内存泄漏,Laravel worker 不自动释放模型静态属性,跑太久会 OOM - 用
php artisan queue:listen是调试用的,它每次任务都 reload 应用,性能差,禁止上生产
高频功能做异步,核心不是“怎么发”,而是“发出去之后谁保证它真跑、跑错怎么兜住、跑挂了有没有人知道”。驱动配置、序列化边界、进程守卫这三块漏掉任何一块,都可能让异步变成“假装异步”。











