Symfony2监听kernel.exception事件处理404异常-php教程-PHP中文网

在 Symfony 2 中，必须使用 kernel.exception 事件处理 404 异常，因为 NotFoundHttpException 在控制器执行前由内核抛出，仅该事件能在此阶段可靠拦截并自定义响应。

symfony2监听kernel.exception事件处理404异常

在 Symfony 2 中，监听 kernel.exception 事件是统一捕获和处理 404（NotFoundHttpException）等异常的正确方式，而不是在控制器里手动 try-catch 或依赖默认错误页。

为什么必须用 kernel.exception 处理 404

Symfony 的 NotFoundHttpException 是在路由未匹配或控制器/动作不存在时由内核自动抛出的，它发生在控制器执行前。只有 kernel.exception 事件能在这个阶段可靠拦截——此时响应尚未生成，你仍有完整控制权：

避免返回原始 HTML 错误页（对 API 尤其致命）
可复用 Serializer、保持与正常接口一致的字段结构（如 error.code、error.message）
保留原始 HTTP 状态码（404）、响应头（如 X-Content-Type-Options）
支持按请求类型差异化响应（如 JSON vs HTML）

创建并注册异常监听器

新建监听器类（例如 src/EventListener/ExceptionListener.php），实现标准方法：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

接收 Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent（Symfony 2.x 对应版本）
检查异常是否为 NotFoundHttpException：$e instanceof NotFoundHttpException
调用 $event->setResponse($response) 提前终止流程，返回自定义响应
在 config/services.yml 中显式注册，打上事件标签：

yaml

services:
    app.exception_listener:
        class:     App\EventListener\ExceptionListener
        tags:
            - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }

针对 404 的典型响应逻辑

在 onKernelException 方法中，优先判断请求是否为 API 调用（例如检查 Accept: application/json）：

是 JSON 请求：返回标准化 JSON，状态码 404，包含 {"error": "not_found", "message": "Resource not found"}
是普通 HTML 请求：可重定向到友好错误页（如 /error/404），或渲染自定义 Twig 模板
不要 throw 新异常，避免二次触发事件链