dispatch()不能直接传数组，因其方法签名仅接受单个任务实例；应使用bus::batch()批量派发，它创建共享生命周期的批处理作业，要求传入已实例化的任务对象，并注意队列驱动配置与分块策略。
为什么 dispatch() 不能直接传数组？
很多人试过直接写 Job::dispatch([1, 2, 3]) 或 dispatch([new Job(1), new Job(2)])，结果报错：Serialization of 'Closure' failed 或直接抛出 TypeError。这是因为 Laravel 的 dispatch() 方法签名只接受单个任务实例（或支持自动封装的参数），底层调用的是 dispatchNow() 或 push()，不支持批量解析数组。
用 Bus::batch() 实现真正可控的批量派发
Bus::batch() 是 Laravel 8.5+ 提供的原生批量调度方案，它不是“一口气塞多个任务进队列”，而是创建一个批处理作业（Batch），每个任务仍独立入队，但共享生命周期管理（如完成回调、失败处理、取消能力）。
实操建议：
- 必须用
use Illuminate\Support\Facades\Bus; - 传入数组元素必须是已实例化的任务对象，不能是类名字符串或未初始化的
new Job(...)调用（会因闭包/作用域问题序列化失败） - 避免在任务构造函数中传入非可序列化对象（如
Request、UploadedFile、数据库连接） - 若需传递原始数据，改用简单类型（
int、string、array）或 Eloquent 模型 ID，然后在handle()中重新查询
示例：
use Illuminate\Support\Facades\Bus;
use App\Jobs\ProcessPodcast;
$jobs = [
new ProcessPodcast(1),
new ProcessPodcast(2),
new ProcessPodcast(3),
];
$batch = Bus::batch($jobs)->then(function ($batch) {
\Log::info('所有任务执行完成', ['batch_id' => $batch->id]);
})->catch(function ($batch, $e) {
\Log::error('批处理中某个任务失败', ['batch_id' => $batch->id, 'exception' => $e->getMessage()]);
})->dispatch();
// 获取 batch ID 用于后续查询
$batchId = $batch->id;
大批量时别硬扛：用 foreach + dispatch() 更稳
当你要派发几百甚至上千个任务（比如导出 5000 条用户数据），Bus::batch() 反而可能成为瓶颈：它会在数据库 job_batches 表里写一条记录，并为每个任务生成独立队列条目——这本身没问题，但如果你没配好队列驱动（比如用 sync 或低配 database），或者 Redis 内存吃紧，就容易卡住或超时。
更务实的做法是分块 + 异步触发：
- 用
collect($ids)->chunk(50)把 ID 列表切片 - 每个分块封装成一个轻量级任务（如
DispatchChunkJob::dispatch($chunk)），由它内部循环 dispatch 子任务 - 这样既避免单次请求内存爆炸，又防止 DB/Redis 单次写入压力过大
- 注意：不要在
DispatchChunkJob::handle()里用sleep()或长循环阻塞，应确保每个子任务真正异步
查不到任务？检查队列驱动和 failed_jobs 表结构
批量派发后发现任务没执行，常见原因不是代码写错了，而是环境配置没跟上：
-
QUEUE_CONNECTION=sync会导致任务同步执行（看似“立刻完成”，实则没走队列）——开发时方便，上线必须切到redis或database - 用
database驱动时，确认已运行php artisan queue:table和php artisan migrate，且failed_jobs表存在（Laravel 9+ 要求该表必须存在，否则批量任务失败时不入库） - Redis 连接失败时，
Bus::batch()会静默失败（不抛异常），建议加一层try/catch包裹Bus::batch(...)->dispatch()并记录日志
最容易被忽略的一点：批量任务的「完成状态」只反映 Batch 元数据是否更新成功，不代表所有子任务都跑完了——要看 jobs 表有没有对应记录，以及 artisan queue:work 是否正在运行。
