中间件是请求链上的同步处理器，必须返回Response或调用$next()；事件监听器是被动响应内核广播的订阅者，不参与请求流。前者在路由前可修改请求，后者仅能响应已发生的事件。
在 Symfony 8.1 中，中间件和事件监听器是两种不同层级的请求处理机制，初学者容易混淆。它们都可用于拦截请求，但设计目标、执行时机、注册方式和适用场景有本质区别。掌握它们的核心差异和基础用法，是写出可维护、可扩展应用的关键一步。
中间件：请求链上的同步处理器
中间件是一个函数式组件，它位于 HTTP 请求到响应的主干路径上，必须返回 Response 或调用 $next() 向下传递。它天然支持顺序执行和上下文修改。
- 类需实现
__invoke(Request $request, RequestHandlerInterface $next): Response - 注册在
config/packages/framework.yaml的http_middleware下，按顺序执行 - 可在路由解析前修改请求（如重写 URI、注入 header、解密 body）
- 适合全局行为：CORS 头添加、请求耗时统计、会话初始化
事件监听器：被动响应内核广播
事件监听器不参与请求流，而是等待 EventDispatcher 主动“喊一声”（比如触发 kernel.request），然后执行逻辑。它无法阻断或替换整个流程，除非显式调用 $event->stopPropagation()。
- 可实现
EventSubscriberInterface或仅打kernel.event_listener标签 - 监听
kernel.request时拿到的是已解析的Request，不能反向影响路由匹配 - 适合副作用操作：记录日志、发送通知、更新缓存、异常上报
- 优先级通过
priority参数控制，仅在同一事件内生效
快速上手：一个日志中间件示例
创建 src/Middleware/RequestLoggerMiddleware.php：
namespace App\Middleware;
<p>use Psr\Log\LoggerInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\HttpKernelInterface;
use Symfony\Component\HttpKernel\KernelEvents;
use Symfony\Component\HttpKernel\KernelInterface;
use Symfony\Component\HttpKernel\RequestHandlerInterface;</p><p>class RequestLoggerMiddleware
{
public function __construct(private LoggerInterface $logger) {}</p><pre class="brush:php;toolbar:false;">public function __invoke(Request $request, RequestHandlerInterface $next): Response
{
$startTime = microtime(true);
$response = $next->handle($request);
$duration = (microtime(true) - $startTime) * 1000;
$this->logger->info(sprintf(
'Request: %s %s → %d (%.1fms)',
$request->getMethod(),
$request->getPathInfo(),
$response->getStatusCode(),
$duration
));
return $response;
}}
在 config/packages/framework.yaml 中启用：
framework:
http_middleware:
- 'App\Middleware\RequestLoggerMiddleware'
常见误区提醒
- 不要在
kernel.request监听器里试图修改请求方法或 URI 并期望路由重匹配——它已经完成了 - 避免用闭包注册监听器（
$dispatcher->addListener()），生产环境可能失效 - 中间件中访问
$request->getSession()安全；监听器中首次调用可能触发 session 启动延迟 - 若需按路由条件执行逻辑（如仅对 API 路由加 Token 验证），优先用属性路由 + 拦截器，而非全局中间件硬判断
