Symfony 2.8中AJAX请求返回403 JSON响应而非跳转的实现

我之前在Symfony 2.8开发Web应用时也碰到过这个需求——用户未登录的时候，AJAX请求总被重定向到登录页，这对前端来说太不友好了，得改成返回403的JSON响应才行。下面是我亲测有效的实现方案：

1. 编写AccessDenied监听器 #

首先创建一个监听器类，专门捕获权限不足的异常，判断请求是否为AJAX，然后替换响应为JSON格式的403：

use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\Security\Core\Exception\AccessDeniedException;

class AccessDeniedListener
{
    public function onAccessDeniedException(GetResponseForExceptionEvent $event)
    {
        $exception = $event->getException();
        
        // 精准匹配权限不足异常，同时确认是AJAX请求
        if ($exception instanceof AccessDeniedException && $event->getRequest()->isXmlHttpRequest()) {
            // 返回自定义的JSON错误响应，状态码设为403
            $response = new JsonResponse(
                ['message' => '权限不足，请先登录'],
                JsonResponse::HTTP_FORBIDDEN
            );
            
            $event->setResponse($response);
            // 停止事件传播，避免后续监听器覆盖我们的响应
            $event->stopPropagation();
        }
    }
}

2. 注册监听器服务 #

接下来要把这个监听器注册到Symfony的事件系统里，修改app/config/services.yml（如果用XML配置就对应修改services.xml）：

services:
    app.access_denied_listener:
        class: AppBundle\EventListener\AccessDeniedListener
        tags:
            - { name: kernel.event_listener, event: kernel.exception, method: onAccessDeniedException }

3. 一些关键细节 #

• 我没有直接判断错误码403，而是用instanceof AccessDeniedException，因为有些非权限类的异常也可能返回403状态码，这样能更精准地处理我们要的场景。
• 调用stopPropagation()很重要，它能阻止其他异常监听器继续处理这个事件，确保我们的JSON响应能直接返回给前端。
• JSON里的返回内容可以完全自定义，比如换成['error' => 'Access denied']或者你需要的任何结构。

这样配置完成后，当未登录用户发起AJAX请求触发权限验证失败时，前端就会收到一个403状态码的JSON响应，而不是被强制重定向到登录页面了。

内容的提问来源于stack exchange，提问作者engel