Symfony Security 组件需显式配置防火墙匹配路径、用户提供者、User类契约方法和AuthorizationCheckerInterface权限判断四环节，缺一即导致登录失败或权限失效。
Symfony Security 组件不是开箱即用的“安全开关”，它必须显式配置四个关键环节才能正常工作：防火墙匹配路径、用户提供者能查到用户、User 类实现契约方法、权限判断走 AuthorizationCheckerInterface。漏掉任一环，都会出现登录无响应、认证失败或 isGranted() 总返回 false 等问题。
防火墙没拦到请求？检查 pattern 和 check_path 是否对得上
登录表单提交后静默失败，90% 是防火墙根本没处理这个请求。Security 管道只处理被某个 firewall 的 pattern 匹配到的请求。
-
pattern必须覆盖你的登录提交路径 —— 比如路由是/auth/login，就不能只写^/admin，至少得是^/auth或^/ -
form_login.check_path值（如app_login）必须和你实际定义的路由名完全一致；若用路径（如/login_check），要确保该路径未被其他防火墙提前拦截 - 多个防火墙按 YAML 定义顺序匹配，第一个
pattern匹中的就生效 —— 别让dev防火墙（pattern: ^/(_(profiler|wdt)|css|images|js)/）或api防火墙（pattern: ^/api）把main防火墙的请求“截胡”了
用户查不到？确认 providers 配置与实体映射是否完整
防火墙接住了请求，但认证仍失败，常见原因是用户提供者返回空或抛异常。
- 用 Doctrine 实体时，
providers必须指定class（如App\Entity\User）和唯一字段property（如email），且该字段在数据库中必须有唯一索引 - User 实体必须正确声明主键（
@ORM\Id+@ORM\GeneratedValue），否则EntityUserProvider会抛出You cannot refresh a user... - 内存提供者（
in_memory）仅用于开发测试，正式环境务必切换为entity或自定义 provider
User 类缺方法？getRoles()、getPassword()、getUserIdentifier() 一个不能少
Security 在认证流程中会主动调用这些方法，缺任何一个都会中断流程或导致 Session 用户反复重加载。
-
getRoles()必须返回非空数组（如['ROLE_USER']），返回[]或null会直接拒绝认证 -
getPassword()必须返回已哈希密码字符串（如$2y$13$...），绝不能返回明文或空字符串 - Symfony 6.1+ 必须实现
getUserIdentifier()（推荐返回邮箱或 ID 字符串），旧版用getUsername()；该值需全局唯一且稳定，不能随每次查询变化 - 强烈建议实现
EquatableInterface，否则用户角色变更后可能因isEqualTo()判定失败而触发重复加载
权限总不生效？别读 $user->getRoles()，改用 AuthorizationCheckerInterface
在控制器里直接调用 $user->getRoles() 判断权限，等于绕过了整个 Symfony 授权系统 —— 角色继承、voter、表达式语言（is_granted('ROLE_ADMIN')）、@IsGranted 注解全部失效。
- 注入
AuthorizationCheckerInterface $authChecker，用$authChecker->isGranted('ROLE_ADMIN')或$authChecker->isGranted('EDIT', $post) - 模板中用
is_granted('ROLE_ADMIN')Twig 函数，它底层也是调用同一个接口 - 方法级控制优先用
@IsGranted("ROLE_ADMIN")属性，它自动触发 voter 链和表达式评估，比硬编码 if 更健壮
最易被忽略的是 getUserIdentifier() 返回值的稳定性 —— 如果它依赖数据库实时查询且结果不一致，会导致用户登录后 Session 中的 User 对象被判定为“不等价”，从而反复触发 refreshUser()，最终耗尽内存或报错。这个点不在文档显眼位置，但线上故障频发。
