Symfony 5.4中无法自定义Access Denied异常的求助

针对用户权限不足时显示自定义页面的需求，有两种实用方案可以实现：

方案一：直接使用自定义错误模板 #

Symfony 默认会根据HTTP状态码加载对应的错误模板，403状态码对应权限不足场景，只需创建对应模板即可：

1. 手动创建目录 templates/bundles/TwigBundle/Exception/（如果不存在）
2. 在该目录下新建 error403.html.twig 文件，写入自定义页面内容：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>权限不足</title>
</head>
<body>
    <div class="error-container">
        <h1>抱歉，您没有访问该页面的权限</h1>
        <p>请确认您的账号权限，或联系管理员获取帮助</p>
        <a href="{{ path('homepage') }}">返回首页</a>
    </div>
</body>
</html>

当系统抛出Access Denied异常时，会自动渲染这个模板，替代默认错误页面。

方案二：通过事件监听器实现灵活处理 #

如果需要根据用户角色、请求路径等做更个性化的逻辑（比如记录日志、显示不同提示），可以用事件监听器捕获AccessDeniedException：

1. 创建监听器类 src/EventListener/AccessDeniedListener.php：

<?php

namespace App\EventListener;

use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;
use Symfony\Component\HttpKernel\KernelEvents;
use Symfony\Component\Security\Core\Exception\AccessDeniedException;
use Twig\Environment;

class AccessDeniedListener
{
    private $twig;

    public function __construct(Environment $twig)
    {
        $this->twig = $twig;
    }

    public function onKernelException(ExceptionEvent $event)
    {
        $exception = $event->getThrowable();

        // 仅处理AccessDeniedException
        if (!$exception instanceof AccessDeniedException) {
            return;
        }

        // 渲染自定义模板，可根据需求传递变量（比如当前用户角色）
        $content = $this->twig->render('security/access_denied.html.twig', [
            'user' => $event->getRequest()->getUser()
        ]);

        $response = new Response($content, Response::HTTP_FORBIDDEN);
        $event->setResponse($response);
    }
}

2. 在templates/security/目录下新建access_denied.html.twig，写入自定义内容：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>权限不足</title>
</head>
<body>
    <h1>权限不足提示</h1>
    {% if user %}
        <p>尊敬的 {{ user.username }}，您没有权限访问此页面</p>
    {% else %}
        <p>请先登录后再尝试访问</p>
    {% endif %}
    <a href="{{ path('homepage') }}">返回首页</a>
</body>
</html>

3. 注册监听器服务：
   • 若使用Symfony 5.3+，可以直接在监听器类上方添加属性：

     #[AsEventListener(event: KernelEvents::EXCEPTION, priority: 10)]
     

   • 或者在config/services.yaml中配置：

     services:
         App\EventListener\AccessDeniedListener:
             arguments: ['@twig']
             tags:
                 - { name: kernel.event_listener, event: kernel.exception, priority: 10 }
     

   设置priority:10是为了确保我们的监听器优先于Symfony默认的异常处理器执行。

注意事项 #

确保security.yaml中的access_control配置正确，比如：

# config/packages/security.yaml
security:
    # ... 其他配置
    access_control:
        - { path: ^/admin, roles: ROLE_ADMIN }
        - { path: ^/user-center, roles: ROLE_USER }

这样当用户访问无权限路径时，才会触发对应的异常，进而执行我们的自定义逻辑。

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