Symfony 6表单认证报错及make:auth生成自定义认证器求助

一、"Invalid Credentials" 错误排查 #

• 验证密码哈希逻辑：创建用户时必须通过UserPasswordHasherInterface对密码进行哈希处理，禁止存储明文密码。示例代码：

  $user->setPassword($passwordHasher->hashPassword($user, '原始密码'));
  

• 检查防火墙配置：在config/packages/security.yaml中，确保表单登录的login_path和check_path与路由名称匹配，且被目标防火墙覆盖：

  security:
    firewalls:
      main:
        form_login:
          login_path: app_login
          check_path: app_login
  

• 确认用户实体方法正确性：User实体的getPassword()必须返回哈希后的密码字段；如果实现了isEnabled()、isAccountNonLocked()等状态方法，需确保用户处于可用状态。
• 核对登录字段匹配：确保登录表单提交的_username字段与security.yaml中provider配置的property（如username或email）一致。

二、创建基础表单认证器 #

Symfony 6 的make:auth默认生成自定义认证器，若需基础表单登录，可手动完成以下配置：

1. 生成登录控制器 #

执行命令：

php bin/console make:controller LoginController

修改控制器代码，集成Symfony认证工具类：

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;

class LoginController extends AbstractController
{
    #[Route('/login', name: 'app_login')]
    public function index(AuthenticationUtils $authenticationUtils): Response
    {
        $error = $authenticationUtils->getLastAuthenticationError();
        $lastUsername = $authenticationUtils->getLastUsername();

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

    #[Route('/logout', name: 'app_logout')]
    public function logout(): void
    {
        throw new \LogicException('此方法由安全系统自动处理，无需编写业务逻辑');
    }
}

2. 创建登录模板 #

在templates/login/index.html.twig中添加登录表单：

{% extends 'base.html.twig' %}

{% block body %}
    {% if error %}
        <div class="alert alert-danger">{{ error.messageKey|trans(error.messageData, 'security') }}</div>
    {% endif %}

    <form method="post">
        <label for="username">用户名:</label>
        <input type="text" id="username" name="_username" value="{{ last_username }}">

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

        <input type="checkbox" id="remember_me" name="_remember_me" checked>
        <label for="remember_me">记住我</label>

        <button type="submit">登录</button>
    </form>
{% endblock %}

3. 配置安全文件 #

修改config/packages/security.yaml，启用基础表单认证：

security:
    enable_authenticator_manager: true
    password_hashers:
        App\Entity\User:
            algorithm: auto

    providers:
        app_user_provider:
            entity:
                class: App\Entity\User
                property: username # 可替换为email等登录标识字段

    firewalls:
        dev:
            pattern: ^/(_(profiler|wdt)|css|images|js)/
            security: false
        main:
            lazy: true
            provider: app_user_provider
            form_login:
                login_path: app_login
                check_path: app_login
                enable_csrf: true
            logout:
                path: app_logout
                target: app_homepage # 注销后跳转路由

    access_control:
        - { path: ^/login, roles: PUBLIC_ACCESS }
        - { path: ^/, roles: ROLE_USER }

4. 确保用户实体符合规范 #

User实体必须实现Symfony\Component\Security\Core\User\UserInterface，并完成所有方法实现：

namespace App\Entity;

use Symfony\Component\Security\Core\User\UserInterface;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: App\Repository\UserRepository::class)]
class User implements UserInterface
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private $id;

    #[ORM\Column(type: 'string', length: 180, unique: true)]
    private $username;

    #[ORM\Column(type: 'json')]
    private $roles = [];

    #[ORM\Column(type: 'string')]
    private $password;

    public function getUserIdentifier(): string
    {
        return (string) $this->username;
    }

    public function getUsername(): string
    {
        return $this->getUserIdentifier();
    }

    public function getRoles(): array
    {
        $roles = $this->roles;
        $roles[] = 'ROLE_USER';
        return array_unique($roles);
    }

    public function getPassword(): string
    {
        return $this->password;
    }

    public function eraseCredentials(): void
    {
        // 若临时存储了明文密码，在此清空
    }

    // 其他getter/setter方法...
}

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