Symfony 5.3 移除FOSUserBundle后如何实现用户名或邮箱均可登录

1. 调整用户提供者查询逻辑 #

默认的EntityUserProvider仅会按单一字段查询用户，你需要修改配置自定义查询规则：

修改security.yaml配置 #

# config/packages/security.yaml
security:
    providers:
        app_user_provider:
            entity:
                class: App\Entity\User
                # 移除原来的property: email配置，替换为自定义仓库查询方法
                repository_method: loadUserByIdentifier

新增UserRepository查询方法 #

在你的UserRepository类中新增loadUserByIdentifier方法，支持同时匹配邮箱和用户名：

// src/Repository/UserRepository.php
use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
use Symfony\Component\Security\Core\User\UserInterface;

public function loadUserByIdentifier(string $identifier): UserInterface
{
    $user = $this->createQueryBuilder('u')
        ->where('u.email = :identifier OR u.username = :identifier')
        ->setParameter('identifier', $identifier)
        ->getQuery()
        ->getOneOrNullResult();

    if (!$user) {
        throw new \Symfony\Component\Security\Core\Exception\UserNotFoundException();
    }

    return $user;
}

// 同步升级refreshUser方法保持兼容
public function refreshUser(UserInterface $user): UserInterface
{
    if (!$user instanceof User) {
        throw new UnsupportedUserException(sprintf('Instances of "%s" are not supported.', get_class($user)));
    }

    return $this->find($user->getId());
}

2. 调整登录表单配置 #

修改表单字段 #

将登录页的账号输入框的name属性改为通用名称，比如_username，无需限制输入格式为邮箱。

同步security.yaml防火墙配置 #

security:
    firewalls:
        main:
            form_login:
                # 和表单账号输入框的name属性保持一致
                username_parameter: _username
                password_parameter: _password
                # 其余原有配置（登录页路径、登录成功跳转路径等）保持不变

3. 修正User类标识方法 #

删除已废弃的getUsername()方法，保留官方推荐的getUserIdentifier()即可，该方法返回用户唯一标识（邮箱或用户名均可，不影响双字段登录逻辑）：

// src/Entity/User.php
public function getUserIdentifier(): string
{
    // 示例返回邮箱，你也可以根据业务需求返回username
    return $this->email;
}

注意事项 #

• 请提前为数据库username和email字段添加唯一索引，避免出现同一个输入值匹配到多个用户的异常
• 原有密码哈希逻辑无需修改，只要User类的getPassword()方法返回正确的密码哈希值即可
• 如果使用Symfony 5.3+的新认证系统，自定义认证器的getUser()方法直接调用上述loadUserByIdentifier即可，无需额外修改

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