Symfony2EventListener监听404异常跳转页面-php教程-PHP中文网

symfony 2 中 kernel.exception 无法捕获默认 404，因其属路由正常流程而非异常；需启用 strict_requirements 或显式抛出 notfoundhttpexception 才能触发监听器跳转。

symfony2eventlistener监听404异常跳转页面

在 Symfony 2 中，kernel.exception 事件监听器无法直接捕获 404 异常并跳转页面，因为 404（NotFoundHttpException）在 Symfony 2 的请求流程中不是以未捕获异常形式抛出的，而是由路由系统主动触发的“正常流程分支”，通常不会进入 kernel.exception 事件链。

换句话说：
✅ kernel.exception 只响应真正未被 try/catch 捕获、且由内核抛出的 Exception 实例（如 Twig_Error_Runtime、自定义业务异常等）。
❌ 路由失败导致的 404 默认不抛异常，而是由 RouterListener 内部处理后直接返回 Response（状态码 404），跳过异常事件。

如何让 404 触发跳转？两种可靠方式

✅ 方式一：启用 `throw 404 as exception`（推荐）

Symfony 2 支持将路由/控制器找不到的行为转为真实异常，从而激活 kernel.exception 监听器：

在 app/config/config.yml 中开启异常模式：

# app/config/config.yml
framework:
 router:
     strict_requirements: ~
 # 关键：强制将 404 视为异常
 templating:
     engines: ['twig']

更重要的是——确保 RouterListener 抛出异常：
默认情况下，Symfony 2 的 RouterListener 在找不到路由时调用 $event->setResponse($response) 并返回 404 响应，不抛异常。
你需要替换或包装它，或改用更可控的方式：

✅ 实际最简有效做法：在 app/AppKernel.php 中注册自定义 RouterListener 或覆盖默认行为
但更轻量、兼容性更好的方案是——统一用 ExceptionListener 拦截所有 NotFoundHttpException，前提是它真被抛出来了。

所以先确认：你的 404 是否真的作为异常抛出？

检查是否启用了 debug: true 和 strict_requirements: true（开发环境默认开启）；
确保没有其他 bundle（如 FOSRestBundle）提前拦截了 404 并返回响应；
在控制器中手动抛出 new NotFoundHttpException('Not found') —— 这个一定会触发 kernel.exception。

✅ 方式二：用 `kernel.request` + 路由匹配预检（绕过异常机制）

如果你的目标只是“访问不存在路径时跳转到 /not-found 页面”，不依赖异常事件，可监听 kernel.request：

Symfony Linux版

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

下载

// src/YourBundle/EventListener/NotFoundRedirectListener.php
namespace YourBundle\EventListener;

use Symfony\Component\HttpKernel\Event\GetResponseEvent;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
use Symfony\Component\HttpFoundation\RedirectResponse;

class NotFoundRedirectListener
{
    public function onKernelRequest(GetResponseEvent $event)
    {
        if (!$event->isMasterRequest()) {
            return;
        }

        $request = $event->getRequest();
        try {
            // 手动触发路由匹配（需注入 RouterInterface）
            $this->router->match($request->getPathInfo());
        } catch (NotFoundHttpException $e) {
            $event->setResponse(new RedirectResponse('/not-found'));
        }
    }
}

⚠️ 注意：$this->router->match() 在 Symfony 2 中可能抛 ResourceNotFoundException（非 NotFoundHttpException），需 catch 对应异常类；且性能略低（重复匹配），仅适合简单场景。

✅ 正确注册一个能捕获 404 的 `ExceptionListener`

假设你已确保 NotFoundHttpException 被抛出（例如通过控制器显式 throw，或启用严格路由+调试模式），监听器写法如下：

// src/YourBundle/EventListener/ExceptionListener.php
namespace YourBundle\EventListener;

use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
use Symfony\Component\HttpFoundation\RedirectResponse;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class ExceptionListener
{
    public function onKernelException(GetResponseForExceptionEvent $event)
    {
        $exception = $event->getException();

        if ($exception instanceof NotFoundHttpException) {
            $response = new RedirectResponse('/not-found');
            $event->setResponse($response);
        }
    }
}

注册服务（app/config/services.yml）：

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

⚠️ 常见失效原因（重点排查）

Symfony 2 默认 不把 404 当异常抛出，除非你主动 throw 或配置了严格模式且路由完全失败；
生产环境 debug: false 时，NotFoundHttpException 可能被静默转为 404 响应，不进监听器；
kernel.exception 监听器优先级太低，被其他 bundle（如 SensioFrameworkExtraBundle）的监听器抢先设置了响应；
缓存未清除：修改后运行 php app/console cache:clear --env=prod（生产）或 --env=dev（开发）。