Symfony 6.2+ 中 @IsGranted 等注解报错主因是 SensioFrameworkExtraBundle 未安装或未启用，推荐改用 Symfony 原生 #[IsGranted] 和 #[Security] 属性。
权限注解报错，大概率不是写错了，而是环境或配置没对上。SensioFrameworkExtraBundle 的 @IsGranted 和 @Security 在 Symfony 6.2+ 已被官方弃用，不再随新项目默认安装——这点最容易被忽略。
确认是否已安装并启用 bundle
如果你用的是 Symfony 6.2 或更高版本（当前是 2026 年，大概率是 7.x），SensioFrameworkExtraBundle 默认不包含。必须手动安装：
- 运行
composer require sensio/framework-extra-bundle - 检查
config/bundles.php中是否启用：Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true] - 确保
framework.extra_framework.enabled: true在config/packages/framework.yaml中存在（Symfony 6.4+ 可能需显式开启）
注解语法是否匹配 Symfony 版本
老项目常用 @Route、@IsGranted 这类 @ 开头的注解；但 Symfony 8+ 推荐使用 PHP Attributes（#[Route]、#[IsGranted]）。两者不能混用：
- 若用
@IsGranted("ROLE_ADMIN")，需确保use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;存在，且 bundle 已正确加载 - 若用
#[IsGranted("ROLE_ADMIN")]，则不需要 SensioBundle —— Symfony 自带的Symfony\Component\Security\Http\Attribute\IsGranted即可支持（推荐迁移到这个） - 错误示例：
@IsGranted写在没装 bundle 的项目里，会直接报 “class not found”
权限检查失败却无提示？查 voter 和角色名
@IsGranted 报错常表现为 403 或空白页，实际是权限拒绝未被捕获。重点检查：
- 用户是否真有该角色？用
$this->getUser()?->getRoles()打印验证，注意角色名全大写、带ROLE_前缀 - 自定义 voter 是否抛出异常？voter 的
voteOnAttribute方法返回VoteResult::ABSTAIN会导致@IsGranted视为“未授权” - 对象级权限（如
@IsGranted("EDIT", subject: "post")）中，post参数必须存在且非 null，否则直接拒绝
替代方案：优先用 Symfony 原生安全属性
从 Symfony 5.4 起，框架自带更轻量、更稳定的权限注解，无需 SensioBundle：
-
#[IsGranted('ROLE_ADMIN')]→ 使用Symfony\Component\Security\Http\Attribute\IsGranted -
#[Security("is_granted('POST_EDIT', post) and user.isVerified()")]→ 使用Symfony\Component\Security\Http\Attribute\Security - 它们与防火墙、voter、表达式语言完全兼容，且不受 SensioBundle 弃用影响
