Laravel虽无原生队列中间件,但可通过队列事件、trait钩子或装饰器模式实现类似功能。1. 使用Queue::before/after全局监听任务执行前后逻辑;2. 定义InteractsWithMiddleware trait,在handle中调用beforeHandle和afterHandle钩子,供具体任务复用;3. 采用LoggingJobDecorator等装饰器类包裹任务,实现可叠加的中间件链。三种方式分别适用于全局处理、任务级增强和复杂流程控制,灵活模拟队列中间件行为。

Laravel 并没有直接提供“队列中间件”这一概念,像路由中间件那样通过 middleware() 方法挂载。但 Laravel 队列任务支持在任务执行前后添加自定义逻辑,这可以通过任务事件或自定义的装饰器模式来实现类似中间件的功能。下面介绍如何模拟和使用“队列任务中间件”。
1. 使用队列事件模拟中间件行为
Laravel 提供了队列事件,可以在任务执行前、执行后、失败时触发回调,适合用于记录日志、监控性能等通用操作。
示例:在 AppServiceProvider 中监听任务事件
use Illuminate\Support\Facades\Queue;
use Illuminate\Queue\Events\JobProcessing;
use Illuminate\Queue\Events\JobProcessed;
class AppServiceProvider extends ServiceProvider
{
public function boot()
{
Queue::before(function (JobProcessing $event) {
// 类似中间件的 before 处理
\Log::info('任务即将执行: ' . $event->job->getName());
});
Queue::after(function (JobProcessed $event) {
// 类似中间件的 after 处理
\Log::info('任务执行完成: ' . $event->job->getName());
});
}
}
这种方式适用于全局逻辑,比如统一的日志记录、性能监控、权限检查等。
2. 创建可复用的任务“中间件”类(装饰器模式)
你可以通过封装一个通用处理类,在任务执行前后插入逻辑,实现类似中间件的效果。
步骤:- 创建一个 trait 或基类,提供 beforeHandle 和 afterHandle 钩子
- 在 handle 方法中调用这些钩子
trait InteractsWithMiddleware
{
protected function middleware($job, $next)
{
$this->beforeHandle($job);
$result = $next($job);
$this->afterHandle($job);
return $result;
}
protected function beforeHandle($job)
{
// 子类可重写
}
protected function afterHandle($job)
{
// 子类可重写
}
}
在具体任务中使用:
class SendWelcomeEmail implements ShouldQueue
{
use InteractsWithMiddleware;
public function handle()
{
return $this->middleware(null, function () {
// 实际业务逻辑
\Log::info('发送欢迎邮件...');
});
}
protected function beforeHandle($job)
{
\Log::info('准备发送邮件...');
}
protected function afterHandle($job)
{
\Log::info('邮件发送完毕');
}
}
3. 使用 Job Decorator 模式(高级用法)
更灵活的方式是使用装饰器类包裹任务,实现真正的中间件链。
示例:创建一个日志装饰器
class LoggingJobDecorator implements ShouldQueue
{
protected $job;
public function __construct($job)
{
$this->job = $job;
}
public function handle()
{
\Log::info('任务开始: ' . get_class($this->job));
$this->job->handle();
\Log::info('任务结束: ' . get_class($this->job));
}
}
分发任务时包装:
dispatch(new LoggingJobDecorator(new SendWelcomeEmail()));
你还可以叠加多个装饰器,如重试、缓存、速率控制等。
总结:Laravel 队列“中间件”的实现方式
- 全局逻辑用 Queue::before / after 事件
- 任务级通用处理用 trait + 钩子方法
- 复杂流程用 装饰器模式(Job Decorator)
虽然 Laravel 没有原生的队列中间件语法,但通过事件和设计模式完全可以实现更强大、更灵活的控制机制。
基本上就这些,不复杂但容易忽略细节。










