Symfony 5.3新认证器体系下简单登录表单提交无响应问题

问题排查与解决步骤 #

• 检查User实体接口实现
  新的安全系统要求App\Entity\User必须实现Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface接口，缺少这个实现会导致密码校验直接静默失败，无任何报错提示。打开User实体文件修改类定义即可：

use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;

class User implements UserInterface, PasswordAuthenticatedUserInterface
{
    // 原有代码保持不变
}

• 检查登录模板配置
  首先确认你的security/login.html.twig里已经正确输出错误信息，且表单字段名和认证器要求完全匹配：

{# 必须添加这段代码输出错误提示，否则认证失败你看不到任何报错 #}
{% if error %}
    <div class="alert alert-danger">{{ error.messageKey|trans(error.messageData, 'security') }}</div>
{% endif %}

<form method="post">
    <label for="email">邮箱</label>
    <input type="email" id="email" name="email" value="{{ last_username }}" required>

    <label for="password">密码</label>
    <input type="password" id="password" name="password" required>

    {# csrf token的id必须为authenticate，和你认证器里CsrfTokenBadge的第一个参数保持一致 #}
    <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">

    <button type="submit">登录</button>
</form>

添加错误输出代码后重新提交登录，就能看到具体是密码错误、csrf校验失败还是用户不存在的问题。

• 确认测试用户密码为加密存储
  不要直接往数据库插入明文密码，新的密码哈希器不会识别明文密码，会直接判定校验失败。你可以用控制台命令生成合规的加密密码：

php bin/console security:hash-password 你的明文密码

把生成的哈希值存入用户表的password字段后再测试登录。

• 检查跳转路由是否存在
  你当前认证成功后跳转的路由名是dashboard，如果项目中没有定义这个路由会直接触发404，你可以先把跳转地址替换成已经存在的路由测试：

// 修改LoginFormAuthenticator里onAuthenticationSuccess方法的跳转逻辑
return new RedirectResponse($this->urlGenerator->generate('home')); // 替换为你实际存在的路由名

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