Symfony同一模板集成登录注册表单时注册表单提交刷新未入库问题求助

问题根因 #

Symfony执行make:auth生成的配置，默认会将登录路由（你当前设置的/connexion）作为登录校验路径，所有发往该路径的POST请求会优先被安全组件拦截做身份校验。你提交注册表单的请求还没走到Controller里的注册处理逻辑，就被登录校验拦截、验证失败直接刷新页面，所以不会执行数据入库代码。
另外如果没有配置成功跳转，就算注册逻辑执行完，刷新页面也会触发重复提交问题。

解决方案 #

方案1：拆分登录校验路径，同路由兼容两个表单 #

1. 修改安全配置，单独设置登录校验路径
   打开config/packages/security.yaml，找到firewalls.main.form_login配置段，修改check_path为独立路径：

security:
    firewalls:
        main:
            form_login:
                # 把原来默认的app_login改成新的独立路由
                check_path: app_login_check
                login_path: app_login
                # 其余原有配置保持不变

2. 在SecurityController中新增空的登录校验路由，和登出逻辑一样不需要实现代码：

/**
 * @Route("/login-check", name="app_login_check")
 */
public function loginCheck(): void
{
    throw new \LogicException('该方法会被安全防火墙拦截，无需编写实现。');
}

3. 修改模板中登录表单的提交地址，指向新的校验路由：

<form name="login" method="post" action="{{ path('app_login_check') }}" class="connexion__form-connexion">

4. 给注册逻辑增加成功跳转，避免重复提交：
   修改SecurityController的登录方法中注册处理部分：

if ($form->isSubmitted() && $form->isValid()) {
    $user = $form->getData();
    $password = $hasher->hashPassword($user, $user->getPassword());
    $user->setPassword($password);
    $this->entityManager->persist($user);
    $this->entityManager->flush();
    // 跳转到首页或者登录页，可自行替换目标路由名
    $this->addFlash('success', '注册成功，请登录');
    return $this->redirectToRoute('app_home');
}

方案2（更推荐）：独立拆分注册路由 #

将登录和注册逻辑完全拆分，避免后续业务迭代出现冲突：

1. 在SecurityController中新增独立的注册路由：

/**
 * @Route("/inscription", name="app_register")
 */
public function register(Request $request, UserPasswordHasherInterface $hasher): Response
{
    $user = new User();
    $form = $this->createForm(RegisterType::class, $user);
    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $password = $hasher->hashPassword($user, $user->getPassword());
        $user->setPassword($password);
        $this->entityManager->persist($user);
        $this->entityManager->flush();
        $this->addFlash('success', '注册成功，请登录');
        return $this->redirectToRoute('app_login');
    }

    return $this->render('security/login.html.twig', [
        'form' => $form->createView(),
        'last_username' => '',
        'error' => ''
    ]);
}

2. 修改模板中注册表单的提交地址，指向新的注册路由：

{{ form_start(form, {'attr' : {'class' : 'connexion__form-register'}, 'action' : path('app_register') }) }}

调试排查方法 #

如果修改完成后仍然不能正常入库，可以在Controller的$form->handleRequest($request)后加入调试代码，排查是否存在表单验证错误：

$form->handleRequest($request);
if ($form->isSubmitted()) {
    // 打印所有表单验证错误
    dump($form->getErrors(true, false));
    die;
}

通常如果有User实体存在其他必填字段未在表单中配置、字段约束不满足的情况，可以通过这个方法快速定位问题。

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